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INTRODUCTION 


The Dicom Floppy Disk System (FDS) is complemented by a complete 
line of supporting software for the Hewlett Packard 21XX Series 
computers. The FDS can be used as a peripheral in either the 
SIO or BCS environment, or it can be used as the primary I/O 
device under Dicom's Floppy Disk Operating System (FDOS). 


An operating system is an organized collection of programs 
which increases the PRODUCTIVITY of a computer system. An 
operating system's main function is to aid in the preparation, 
translation, debugging, loading, and execution of programs. 
This is accomplished by including a peripheral device in the 
system that can be completely controlled by the computer, thus. 
providing a large program/data base for use by the operating 
system. In FDOS, up to a half-million words of random-access 
storage is provided via disk, with an additional half-million 
bytes of serial-access storage provided via cassettes. 


The various translators, loaders, and other software modules 

of the operating system are stored on the library device (in 
this case a disk) for use only when needed; thus the amount 

of core memory needed for efficient operation is significantly 
reduced. Since the operator requests a translator (assembler, 
compiler, etc.) from disk via an executive command typed 

on the console device keyboard (instead of loading it from paper 
tape), the overhead time can be significantly reduced and the 
efficiencycan be significantly increased. *Also,zsince:the 
computer has complete control of the media containing the input 
data, the translation of the input data can be accomplished 
automatically, thus eliminating operator intervention and 
increasing system throughput (most translators must make multiple 
passes over the input data). 


FDOS isSaCcollection of routines which control the operation of 
application programs and provide them with certain important 


capabilities, primarily in the area of access to peripheral 


devices, i.e., I/O. FDOS supports the HP Assembler, Cross- 
reference Table Generator, Editor, FORTRAN Compiler, and other 

HP and user-provided application programs. It allows these 
programs to perform I/O operations using a wide variety of 
peripheral equipment, including floppy disks, cassettes, paper 
tape, teletype and lineprinter. These devices are treated 
uniformly by the operating system, so as to allow the application 
programs to be device-independent. 


FEATURES OF FDOS 


* 


Immediate usefulness; no special languages or complicated 
procedures to learn. 


Immediate (random) access to all system programs. 


Uniform treatment of peripheral devices. 


Keyboard and batch processing modes. 


Small (approximately 140B words) resident system with all 
remaining memory available to user programs. 


SIO driver package which combines console device, floppy disk, 
cassette, high-speed paper tape, and line printer drivers, 
using common routines to conserve memory. 


Standard programming packages integrated into FDOS, with 
complete floppy disk, cassette, paper tape, and line printer 
I/O facilities: includes editor, assemblers (Floating Point, 
EAU, and Non-EAU), cross-reference table generator, debugger, 
FORTRAN compiler, relocating loader, relocatable library, 

and others. : 


Facilities for converting programs between the various media 
supported (paper tape, disk, and cassette). 


Configurable for I/O configuration and memory size at system 
generation time. 


MINIMUM FDOS HARDWARE CONFIGURATION 


* 


HP 21XX Series computer with 8K of memory (DMA, EAU, memory 
parity, memory protect, time base generator, etc., are NOT 
required). | , 


Console device (HP-interfaced teleprinter or cassette system 
"deck zero" TTY/CRT). 


Single drive Floppy Disk System. 


ADDITIONAL HARDWARE SUPPORTED 


* 


Up to a total of four floppy disk drives 


* Up to a total of 32K memory. 


* Dicom Cassette Magnetic Tape'iSystem (CMTS) or Cassette .: 
Magnetic Tape Terminal (CMTT). 


* High-speed paper tape reader. 
* High-speed paper tape punch. | 


* Line printer (HP-interfaced or cassette system "deck zero" 
line printer). 


* Other peripheral devices with user-supplied SIO or BCS 
compatible drivers. 


FDOS SOFTWARE MODULES 
The FDOS user is supplied: 


* Skeleton system disk containing: 


Configured FDOS for immediate use. 

Unconfigured Bootloader. 

System Generator. 

Unconfigured System Loader. 

Unconfigured SIO Driver Package. 

Unconfigured Executive. 

Assemblers (Floating Point, EAU, and Non-EAU). 
Editor. 

Cross-Reference Table Generator. 

Debugger and Disk Utility Package. 

FORTRAN Compiler (Floating Point/EAU and Non-EAU). 
Prepare Control System. 

Relocating Loader, BCS Drivers, and .IOC. 
Relocatable Libraries (Floating Point, EAU, and Non-EAU). 


* Diagnostic (on paper tape, cassette or disk) 
A configured, "standard" FDOS software system is provided with 
a pre-determined hardware configuration; this allows the user 


to put the FDOS "on-the-air" immediately. 


The System Generator is run to produce a configured System 
Loader, SIO Driver package, and Executive. These can then 


be written out to the "System" files on 
System Generation process need not ever 


The Assemblers, Editor, Cross-Reference 


FORTRAN Compilers, Disk Prepare Control 


Loader modules are modified versions of 


disk, and the 


be performed again. 


Table Generator, 
System, and Relocating 
standard HP programs. 


The Relocatable Libraries, the .10C. and BCS Drivers are 
unmodified HP programs. The Debugger is a: stand-alone octal 
debugger designed for use either with an HP TTY, or with a_ 
cassette system "deck zero" console device. 


il. 


II.A. 


FDOS ORGANIZATION 


The FDOS is a collection of programs designed to work together, 
giving the user a unified treatment of programs and data files. 
FDOS is specially designed to assist in the development and 
execution of programs. 


To this end an editor, assembler, FORTRAN compiler, debugger, 
and other software are stored on disk for quick access when 
needed. These programs are designed to use any FDOS I/O device 
for the various aspects of their input and output, and pro- 
grams generated by the assembler or FORTRAN compiler can later 
be integrated into the system. Such user-generated programs 
can be stored on disk, can make calls on system I/O drivers 

and other utility routines, and can communicate with the 
"Executive" for the purpose of accepting parameters at run time, 
of loading other programs, or of returning control to the 
"Executive". 


It will be especially easy for CMTOS users to learn FDOS, 
Since the commmand structures of the two operating systems are 
quite similar. 


FDOS PERIPHERAL DEVICES 


The FDOS is designed to allow uniform handling of data from 
different peripheral devices.regardless of the media involved. 
Under FDOS, each peripheral device (i.e., paper tape reader, 
paper tape punch, line printer, etc.) or sub-device (Teletype 
keyboard, Teletype printer, disk drives D, E, F, and G) is 
considered to be a physical device. 


In order to take maximum advantage of the disk drives, they are 
broken down further. Each disk drive has four logical units 
assigned to it; Dl, D2, D3, D4, El, E2, .... . , G4; each of 
these sixteen (possible) logical units are considered to be 
a physical device. Each of the logical units within each disk 
has an associated Logical Unit Directory (LUD) which resides on. 
a certain fixed sector of each disk. The contents of each LUD, 
which can be examined by the Logical Unit Directory command (LD), 
is a list of file names. Thus, for example, if the LUD for unit 
El consisted of the names 

SRC1 

SRC2 

SRC3 - 
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II.B. 


and the LUD for unit E2 consisted of the names 

SRC3 

SRC2 

SRC1 

then a command to eeyind logical unit El and copy three files 
from that unit to, say, cassette deck 2 would leave the three 
files .SRC1,SRC2 and SRC3 on the cassette in deck 2 in the 
given order. If the same command were given using logical 
unit E2, then deck 2 would receive the same three files, but 
in the opposite order. 


In addition to the logical unit structure of disk cartridges 
(drives), there is also a structure of named files. There is 
a Disk Directory, kept in a certain fixed disk sector, which 
lists the names and locations of all files actually on that disk. 
A list of the names of ALL files actually on a specific disk can 
be obtained via the Disk Directory command, DI. It should be 


noted that the names of the files in the LUDs will also be ae 


IF there is actually data in the associated file. 


Peripheral devices of FDOS that are actually file-oriented, 

e.g. the cassette decks and the disk logical units, can contain 
more than one file. To this end, commands are provided to posi- 
tion to specific files (Skip, Queue, Rewind, etc.), and to 

a alae files (Copy, ae Save, List, etc.). 


FDOS DEVICE STRUCTURING 
The uniformity in ees handling is accomplished in FDOS by 


having two sets of devices: physical devices, which correspond 
to actual system hardware (peripheral devices), and functional 


devices, which correspond to tasks performed by the system. 


Programs such as the assembler refer only to functional devices. 
The system. translates these I/O requests into operations on 
physical devices and handles all device-specific considerations. 
For example, the normal operation of the assembler requires it 
to pesition the input unit, read through the file, position 

the input unit again, read through the file again, producing | 
binary output on the punch unit, list output to the high- 

speed list unit.or program list unit, write an EOF after the 
binary file on the punch unit, and, if no cross-reference has 
been requested, write. an EOF after the list file on the high- 
speed list unit. The assembler does not need to make special 
provision for paper tape input or output (such as halting 
between TTY print and punch, generating leader/trailer, etc.). 
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It does not need to set up a special pointer for’ lineprinter 
output, or avoid writing file marks on tape or disk when the 
listing has gone to the lineprinter. All it needs to do is 

make calls to the system I/O driver to implement the sequence of 
Operations specified above, and the system I/O driver handles 
all of these device peculiarities. 


This arrangement is similar to the HP BCS arrangement in which 
an EQT and an SQT are defined. 


The physical and functional units recognized by FDOS are 
shown in Table II-l. This table is the key to understanding 
FDOS device handling. The left side of the table shows all | 
of the physical devices which can be supported by the system. 
Any particular system has some subset of these, specified at 
system generation time. 


A table, called the Physical Device Table (PDT) is set up 
during system generation. For each of the devices on the left 
side of table II-l, an entry in the PDT specifies its existance 
and capabilities on that particular system. For example, if 
the system has a high-speed reader but not a punch, the high 
speed tape entry will show input capability but not output 
capability. 


The right side of table II-1 lists the functional devices 
recognized by the system. The Functional Device Table (FDT) 
specifies which physical device is assigned to any given func- 
tional device, and also contains information about the binary 
vs. list capabilities of the particular functional device. | 

A functional device can be either a binary device or a list- 
capable device. List-capable devices interpret I/O calls 
specifying negative counts as page control commands, while 
binary devices interpret these as commands to output in 
binary mode (B or BA, as. specified in Section II.C). 


In the HP SIO environment a peculiar arrangement is provided 
for formatting listings. Normally an SIO driver accepts calls 
of the form . 

(A) = Data count 

(B) = Buffer address 

| JSB Driver. | 

The data count specified is either the number of ASCII charac- 
ters to be output or minus the number of binary words to be 
output. That is, a negative data count specifies that binary 
data is to be output. 
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Certain devices, such as a lineprinter, are not normally used 
for binary output. The SIO drivers for such devices are pro- 
grammed to interpret certain "binary" calls as page spacing 
requests. The driver keeps track of the current page position 
by means of a line counter. When the line count reaches the 
maximum number of lines allowed on a page, the driver causes 
the device to do a "page eject", either by means of a Form 
Feed, or by means of six Line Feeds. : 


In FDOS a similar page spacing facility is provided. Basically, 
paging properties are associated with functional units. Each 
functional unit has associated with it a 5~bit code which 
specifies | 
(1) The unit is binary; that is, no page 
spacing requests are recognized, 
---or--- : 
(2) The paging parameters: 
(a) three bits specifying one of seven 
(1 to 7) system line counters 
assigned to the unit; a line coun- 
ter of B specifies no line counting 
(thus, no page spacing) for this 
unit. | 
(b) two bits specifying one of four 
page feed character options; 
i) L- an appropriate number of 
Line Feeds (to bring the line 
count to 66) is output, and the 
. line counter is reset. . 
ii) F- a Form Feed. (ASCII 14) is 
output and the line counter is 
- reset. 
iii) WN - no output accompanies the page 
advance. The line counter is reset. 
iv) xX - the extra page character 
(specified at System Generation 
Time) is output, and the line 
counter is reset. 


The FDT entry for a list-capable units contains an index (between 
@ and 7) to a table of line counts and a code for the choice of 
page feed character (Line Feed, Form Feed, Null, or "extra page 
character"). | : 


The FDT entry for any particular functional unit can be modi- 


fied by the operator by means of the assign (AS) command of the 
Executive. 


TT - A 


To use this command, the operator types 
—S LUASUFU,PU7LC,PC 


mnemonic code for the functional unit. 


where FU = 

PU = mnemonic code for the physical unit. 
LC = index of the line counter. 
PC = code for page character. 


If the LC and PC parameters are not specified, they are left 
alone in the FDT entry. Since the operator will almost never 
need to change these, the ordinary format of the AS command 
is simply 


AS FU,PU 
to assign the physical device PU to the functional device FU. 
Since it is important for the operator to be able to keep track 
of the FDT assignments, the Executive provides ways to do this. 
To find any given assignment, the operator can type 

AS FU,? 
The system replies by typing 

PU .Name Line-counter Page-character 


where PU is the mnemonic code (see table II-1). If the operator 
wants the entire FDT printed, the command 


LA UNIT 


can be used. The entire table is printed on "UNIT" with an 
entry in the above format for each of the FDT entries. 


In order that the user need worrry as little as possible about 
the FDT, a complete FDT is assembled with the Skeleton FDOS. 

At System Generation time any of these can be modified by state- 
ments in the format used with the Assign command (FU,PU,LC,PC). 


The FDT is stored in the "warm start" file on the system disk 
(S¥S2). Thus, an X7542B, X7544B or X77$@B restart will restore 
the FDT to its system generation time values, but an X754B 
restart, such as used by ASMB, EDIT, etc., to reload the Exec- 
utive, will not modify the FDT. | 7 | 
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FDOS DATA STRUCTURE 


All information stored or accessed by FDOS programs is 
organized into files. These files are composed of records. 
A record is a collection of characters and must conform to one 
of four basic formats (which conform to standard: HP philosphy): 
* A - ASCII. Each record consists of 7-bit ASCII 

codes and ends with a line feed character (octal 12). 

On output, the eighth (parity) bit is always set. 

On input, the eighth (parity) bit is always cleared. 


* B - Relocatable binary. Each record consists of an 
even number of 8-bit characters, to be taken in pairs 
to represent 16-bit computer words. The first char- 
acter of each pair represents the most significant 
half (bits 15-8) of the corresponding word. 


The first character (left half of the first word) of 
the record specifies the total number of words in the 
record. The last word of the record is the checksum 
(the sum of the second through the next-to-last words 
of the record). 


* BA - Absolute binary. Each record consists of an 
even number of 8-bit characters, to be taken in pairs 
to represent 16-bit computer words. The first character 
of each pair represents the most significant half 
(bits 15-8) of the corresponding word. 


The first character (left half of the first word) 

of the record specifies the total number of words in 
the record, minus 3. E.g., if there are 128 words 

in the record, this count will be 125. Absolute 
binary format differs from relocatable binary format 
in this respect. The last word of the record is the. 
checksum (the sum of the second through the next-—to- 
last words of the record). 


* Fixed length binary (for BCS programs only). Each 
record consists of an even number of 8-bit characters, 
_to be taken in pairs to represent 16-bit computer 
words. The first character of each. pair represents the 
most Significant half (bits 15-08) of the corresponding 
word. The record has no included word count; exactly 
as many words (or characters) are read as were asked 
for in the call. 
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When taking input from paper tape, on which there are no 
physical record delimiters, the data mode must be known in 
advance, and is used to determine record boundaries. Thus, 
e.g., a program reading an ASCII record will continue to take 
characters from the paper tape until a line feed character is 
encountered. If asked to read an absolute binary record, 

the program will take the first character read as a data word 
count (n), £fil1 out the first word with the second character 
from tape, read the next 2(n+l1) characters as the next (n+1) 
words of the record, while computing the sum (modulo 216) of 
those (n+l) words, then, finally read the next two characters 
from the tape as the last word of the record, and compare that 
last word (the checksum) with the sum of the previous (n+l) 
words. 

In reality, the checksum computation described in the above ° 
example would not be performed by an I/O driver asked to read 
a record in absolute or relocatable binary format. Instead, _ 
the (n+3) or (n)} words of the record are simply transmitted 

to the calling program, which can then perform the checksum 
computation itself. 


The file structure of the disk follows the paper tape record 
format more closely than the cassette format, Since no special 
record delimiters are recognized by the disk hardware. The 

disk structure supported by the hardware is its division into 
tracks and sectors. The number of sectors per track is a 

power of two, and the "disk address" contains the sector address 
in the least significant portion of the word with the track 
address in the next most significant bits. For this reason, the 
division into tracks is largely unimportant to the software, and 
we speak of the disk address or sector address of data without 
explicit mention of the track. 


A disk sector contains 128 16—bit words; these are assigned 
in FDOS as follows: | 


First word: "Name"; A word derived from the file 
name and serving as a validity check. 


£Second word: "Pointer"; Sector address of the next 
128-word block of the file. Zero 


denotes end-of-—file. 


Remaining 126 words: Data words. 
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The data words are used for storing information in..the same: 
format as used with paper tape. Thus, a disk file can be 
thought of as a paper tape laid out on the disk in a "chain" 
of sectors. The first sector contains the first 252 characters 
of the "tape" in its third through 128-th words. The 253-rd 
through 504-th characters are in the third through 128-th 
words of the second block, and so on. The last block of 

the file contains an end-of-file indication in its "pointer" 
word, marking the end of the "tape", and unused characters of 
the last block are filled with nulls, the "trailer" of the 

u tape" 7 i 


Since the blocks of a disk file are chained together, it is 
only necessary to record the address of the first block of the 
file. This is the function of the disk directory. The disk 
directory contains a four-word entry for each file on the disk. 
Three words are for the name; the fourth contains the sector 
address of the first block of the file. 


In order to go through a file of data stored in this manner it 
is only necessary to know the location of the first sector, 
Since each sector contains a pointer to the next sector of 

the file. The disk directory, stored in track zero, sector 

1 of each disk, contains the names (up to five :characters) 

and starting sectors of the files on that disk. 


The structure of files described above is appropriate to the 
random—-access nature of the disk media. Many programs, however, 
are designed for use with a sequential access device. FORTRAN 
statements such as REWIND and ENDFILE have direct interpreta- 
tions for cassettes but not for disks. Similarly, programs 
running in an SIO environment have no means of making random- 
access references to their I/O units. Thus, in order to achieve 
uniform treatment of all system I/O devices wherever possible, 

a system of "logical units" has been established for each disk. 


There are four logical units on each disk. Each has assigned 

a sector in which its "logical unit directory" or LUD is stored. 
This LUD is a list of file names in a specific order. Those 
files, in that order, constitute the given logical unit, making 
it a sequential access device. The contents of the LUD's, and 
therefore the files in these logical units, are under control 
of the user (see QU, AQ, and LD commands). 
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CMTS Deck @ 

CMTS Deck 1 

CMTS Deck 2 

CMTS Deck 3 

High-speed Paper Tape 
Low-speed (TTY) Paper Tape 
Teletype keyboard/printer 
Lineprinter 

Unused 


Nohexistent Device 

Bit Bucket 

Logical Unit D4 
iT} t DL 
ft thy D2 
it wu D3 
wt $3 B4 
ut il EL 
it iB] E2 
iu tt E3 
t! 1 F4 
i! it FL 
tt Ww F2 
#1 tt F3 
a tt G4 
W i$ GL 
tt $3 G2 


G3 


DI 
PL 
DP 
PK 
HL 
SC 
CK 
CL 
AI 
AL 
AP 
AK 
AH 
AS 
BC 
BM 
S2g 
S21 


| PHYS TCAL DEVICES FUNCTIONAL DEVICES | 


Data Input 

Program List 

Data Output 
Program Keyboard 
High-speed List 
Scratch 

Executive Keyboard 
Executive Listing 
Auxiliary Input | 
Auxiliary List 
Auxiliary Output 
Auxiliary Keyboard 
Auxiliary High-speed List 
Auxiliary Scratch 
Batch Command 
Batch Messages 
Unused 


IIl.E: TABLE II-2; SYSTEM TASK ASSIGNMENTS 


The functional devices are assigned to system eacie in the 
following way. 


1. Executive. 
CK ‘On-line mode keyboard input. 
cL On-line mode executive messages. 
BC Batch mode command input. 
BM Batch mode executive messages. 


2. Assembler. 3 
DI Source input. 
DP Binary output. 
PL Talk to operator (e.g., "TYPE CONTROL STATE.") 
Listings if HL not requested. 
PK Input from operator (e.g., ASMB statement). 
HL Listing output unless PL specified. 


3. Editor 
DI Data input if "/D" specified. 
AI Data input if "/A" specified. 
DP Data output if "/D" specified. 
AP Data output if "/A" specified. 
PL Talk to operator. 
PK Answers from operator. 
Input of edit file if "/T" specified. 
AK Input of edit file if "/A" specified. 


4. Cross-reference Table Generator 
DI Source input. 
PL Talk to operator. 
Listings if HL not requested. 
PK Input from operator (e.g., symbol range). 
HL Listings unless PL specified. 


5.. FORTRAN Compiler 
DI Source input. 
PL Talk to operator. 
Listings if HL not requested. 
SC Intermediate binary scratch file. 
HL List unless PL specified. 
DP Relocatable binary output. 
PK Input from operator. 


6. Disk Prepare Control System 
DI Relocatable binary input. 
PL Talk to operator. 
DP Absolute binary output. 
PK Input from operator. 
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IIIT. FDOS SOFTWARE STRUCTURE 
IILT.A. FDOS BOOTLOADER 


The FDOS Bootloader is a short program which is stored in the 
protected area of memory. After the Bootloader has been 
configured (see Section V.D), it is used to load the System 
Loader from disk; the Bootloader has a second entry that can 
be used to load a file from disk whose initial sector address 
is in the Switch Register. A listing of the Bootloader is 
contained in an appendix of this manual. 


ITI.B. FDOS SYSTEM LOADER 


The FDOS System Loader is the core-resident portion of FDOS; 

it is used to load absolute binary files into memory from disk. 
Most FDOS systems programs (as well as user-added programs, if 
directed within the program) return to a System Loader entry 
which causes the remainder of the operating system to be loaded 
and executed. The System Loader is also used by the Run command 
of the FDOS Executive to load files from disk. A listing of 

the System Loader is contained in an appendix of this manual. 


IIIT.C. FDOS SIO DRIVER 


The SIO Driver provides device control and input and output of 
records in the ASCII, relocatable binary and absolute binary 
modes using disk logical units, cassettes, paper tape, Teletype, 
or lineprinter. It also provides a "system" entry, DIO, 

which accepts control commands and spROvidee status returns (as 
opposed to SIO error halts). 


IIT.D. FDOS MEMORY LAYOUT 


The FDOS System Loader resides near the top of memory; it 
occupies locations X7534B through X7677B, where X= 1,2,3... 
for 8K, 12K, 16K, . .. . Just below it in memory is the 
Communications Region, which is used for interprogram communi- 
cation. Below that, going down to around X34@@B (depending upon | 
the configuration) is the SIO Driver package. Programs which use 
the SIO Driver package (e.g., ASMB, EDIT, CROS) must preserve 
this area (the LWA of available memory can be found in location 
196B). The Executive is normally overlaid by these programs. 
The Executive resides in locations X3499%B through (X-1)4999B. 
Its restart address is (X-1)4999B. 
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TIL.E. 


TIt.Ff. 


LIL .G. 


ILTL.H 


The editor, assembler, etc., load into the lower portion of 
memory (preserving 1f1B-194B and 1@6B) and use as much memory 

as they find available (the remainder minus the SIO Driver pack- 
age, Communications Region, and the Bootloader in the protected 
area of memory). 


FDOS DISK LAYOUT 


The FDOS takes advantage of the removability of the floppy 

disk media by making each disk a self-contained entity. Each 
disk has a Disk Directory in track zero, sector one, and logical 
unit directories in track zero, sectors 4, 5, 6, and 7. These 
correspond, respectively, to logical units 4, 1, 2, and 3. In 
addition, five "fixed address files" (sectors 13B, 14B, 15B, 16B 
and 17B) are reserved for system use. The remaining sectors 

of the disk (2@B thru 1777B) are originally placed on a free 
storage list, and then assigned to files as needed. : 


FDOS EXECUTIVE 


The FDOS Executive provides batch or keyboard control of utility 
functions and program loading. Commands include copying of 

data from one device to another, control of cassettes or 

disk logical units, preparation and examination of directories, 
and running named files. 


MEMORY RELEASING 


The FDOS SIO Driver combines the drivers for the various 
peripherals supported into one Driver, thus eliminating re- 
dundant (unnecessary) coding and conserving space. During 
System Generation (see Section V.F) the user specifies which 
peripherals are not to be used; the corresponding section of 
the SIO Driver is thus released, and the appropriate portions 
of FDOS are moved up to give the released area to the user. 


FDOS SOFTWARE STRUCTURE OVERVIEW 


FDOS is a sdftware/hardware package designed to provide the 

user Of HP 2100 or related computers with the utility functions 
necessary for the use of their computers with a wide varity of 
peripheral equipment. The FDOS software provides a modified SIO 
environment in which the exec, Assembler, Editor, FORTRAN and 
associated programs run. It provides the necessary interface with 
the HP BCS environment, so that relocatable programs generated by 
FORTRAN or the Assembler can be loaded in the usual fashion and 
run on the same (or other, if desired) hardware as the FDOS SIO 
environment programs. | 
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The basic I/O device of FDOS is the floppy disk. However, SIO 
software is record-oriented. Furthermore, FDOS achieves a 

uniform treatment of I/O devices. Thus, the FDOS disk format is-. 
designed to make disk files look like very long paper tapes. Each 
disk file is a chain of disk sectors (128 words per sector). The 
first word of each sector is a file identifier derived from the 
file name. It is used by the driver for checking file integrity. 
The second word of the sector is a pointer to the next sector of 
the file. Special codes mark End-of-File or End-of-Disk. The 
pointer contains a disk address (track and sector). No drive bits 
are included in the address, since a given disk cartridge can be 
inserted into any drive. 


The sectors of the disk.are assigned to files from a list of free 
blocks, that is, a file composed of all of the unused sectors. 
The address of this free list and the names and addresses of all 
disk files are kept in the Disk Directory, which is stored in a 
certain fixed sector of each disk cartridge. 


Files are attached to a logical unit by means of the QU and AQ. 
commands. The files comprising a given logical unit may or may 
not be actual disk files. If a file name appears in a LUD but is. 
not an actual disk file, then a file with that name is created if 
output is directed to it. If input from a non-existant file is 
requested, an End-of-Tape condition occurs on that logical unit. 


The disk logical units are sequential-access devices, designed to 
resemble tape drives. The files of a logical unit are in a fixed 
sequence. A rewind command positions the unit to the start of the 
first file of that unit. Reaching an End-of-File on a logical unit 
causes the unit to be positioned to the start of the next file of 
that unit. Proceeding beyond the end of the last file of a logical 
unit creates an End-of-Tape condition. 


FDOS supports up to four floppy disk drives, each having four 
logical units. In addition to floppy disks, FDOS supports a 
variety of other peripheral devices. The various physical devices 
supported are assigned codes by which references to them are to be 
made in the various Executive commands. The following codes and 
corresponding physical devices are recognized by the Executive: 


@ CMTS Deck Zero. This is the "off-line" device of.the 
Dicom Cassette Magnetic Tape System. Normally either a 
console (CRT or TTY) or a lineprinter is attached. 


1 - 3 CMTS cassette decks one thru three. 


HT High-speed paper tape. This refers to two devices - the 
photoreader and the high-speed punch. Output to HT refers 
to the punch; input refers to the photoreader. Either, 
both, or neither can be present in the system hardware 
configuration. | 
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LT Low-speed paper tape. This refers to the TTY reader and 
punch devices of the HP-interfaced teleprinter. 


TY This refers to the keyboard/printer or keyboard/CRT 
interfaced by means of the standard HP TTY interface. 


LP .This refers to the standard HP-interfaced Lineprinter. 
‘It is an output device only. 


D1-D4 -Logical units of drive D. The four floppy disk drives 
supported by FDOS are refered to by the letters D, E, F, 
and G. . The logical units of each are treated as 
‘physical devices. 


E1-E4 Logical units of drive E. 
F1-F4 Logical units of drive F. 
G1-G4 Logical units of drive G. 
BK The Bit Bucket (an infinite write-only memory). 


In order that application programs which are independent of the 
hardware configuration can be provided with the system, a set of 
Functional Units is maintained. Each of these corresponds to a 
particular system function. The actual physical device involved 

is determined by a table in the FDOS SIO Driver. The assignment 

Of Physical Units to Functional Units is made at system generation 
time, and can be (temporarily) changed by the use of the AS command. 
The codes and corresponding Functional Units recognized by the exec 
are as follows: 


‘DP Data output unit (STO 193B device). 

DI Data input unit (SIO 1@1B device). 

PL Program list unit (SIO 1@2B device). 

PK Program keyboard unit (SIO 194B device). 

SC Scratch unit (i.e., pass 1 output of FORTRAN Compiler). 
HL High-speed list unit (lineprinter or disk/tape file). 
BC Batch command input unit. . 

BM Batch message unit. 

AP Auxilary data output unit. 

AI Auxilary data input unit. 

AH Auxilary high-speed list unit. 

AL Auxillary program list unit. 

AK Auxillary program keyboard unit. 

AS Auxillary scratch unit. 

cL Executive's console list unit. 

CK Executive's console keyboard unit. 


The FDOS I/O Driver supports sixteen other units. Users wishing to 
refer to these for use with their own application programs can use © 
the codes SM, Sl, .. ., S15. Physical and Functional devices are 
kept track of by the FDOS I/O Driver. It maintains two tables; the 
Functional Device Table (FDT) and the Physical Device Table (PDT). 
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The Functional Device Table consists of 32 16-bit entries, which 
correspond to the unit numbers 4 thru 77B. Each entry has the 
following format: 


Bits 95-09% Physical Unit (or another Functional Device). 
Bits 11-18 Paging character specification; 
@ Use Null | 
1 Use multiple Linefeeds 
2 Use Extra Paging character (set during sys-gen) 
3 Use Formfeeds 
Bits 14-12 Index to table of seven line counts for page spacing. 
All devices have 66 lines per page, and do page 
spacing after 6% lines. @ means no line counting. 
Bits 14-19 not @ means binary requests (negative 
word count) are treated as form-control commands. 


The Physical Device. Table consists of 16 8-bit entries, which 
correspond to the unit numbers @ thru 17B. The disk Logical Units 
are handled seperately (units 29B thru 37B). The eight bits are 
interpreted as follows: 


Bit 6 Input capability. 

Bit 5 Output capability. 

Bit 4 Disk command capability. 

Bit 3 Always zero. 

Bit 2 Defines a non-file oriented device (viz, Deck Zero, 

High-speed Tape, Low-speed Tape, TTY, Lineprinter). 

This arrangement corresponds to the contents of the Command 
Requirement Table, indexed by driver commands. 


The FDOS I/O Driver provides a "sense" call for sensing the 
capabilities and identity of a Functional or Physical Device. The 
status words returned have the following format: 


B Register 
Bits 4-9 Physical Unit. 
A Register 
Bit. 14 Device has input capability. 
Bit 13 Device has output capability. 
(Bits 14-13 both zero if device doesn't exist). 
Bit 12 Device accepts disk commands. 
Bit 11 (Last) Functional Device does line counting. Ifa 
zero, device accepts binary output commands; if a 
Physical Unit is specified in the call, this bit is 
zero, i.e., all ‘Physical Devices which do output 
have binary rather than list capability. Only 
Functional Devices can have page formatting (line 
counting). . 
Bit 19 Set if device has file-oriented (logical) hardware. 
Bits 6-4 Line counts (from 14-12 of FDT or command). 
Bits 3-2 Paging Character (from 11-18 of FDT or command). 


Bits 6-2 are taken from the noted FDT locations, except for 
three cases; 


coe 


Lit=35 


1. If the device has no list capability (bit 11 
= %), then bits 6-2 are zero. 

2. If the ultimate Physical Device is one which 
ignores functional line counts and page spacing 
characters (viz, Lineprinter, TTY, Deck Zero, 
Bucket), bits 6-4 are zero and bits 3-2 are 3 
(Formfeed). 

3. If the ultimate Physical Device is a disk 
logical unit, then bits 6-4 reflect the actual 
line counter, but bits 3-2 are 3 (Formfeed), 
Since Formfeeds are always used for page 
spacing on disk logical units. 
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IV. 


IV.A. 


IV.B. 


SIO DRIVER PACKAGE DETAILS 


The SIO Driver package contains a combined driver capable of 
supporting the FDS, the cassette system, console device,.line ° 
printer, and high-speed paper tape equipment; a System Loader; 
and a Communication Region. The package also includes a con- 
figuration section to enable the user to adapt the package to 
a particular hardware arrangement and memory Size. 


THE SYSTEM LOADER 


The System Loader is used to load other programs under Executive 
control, or for automatically reloading the Executive after the 
execution of another program. This latter function is accomp- 
lished by means of a transfer to location x754@B, X7542B, or 
X7544B (see Section V.E.3). The locations X7534B-xX7677B must 
not have been changed by the other program. These 144B locations 
constitute the only portion of the system which must remain 
resident in memory for continuous automatic operation. 


The function actually accomplished by the transfer to X754@B, X7542B, 
or X7544B is the automatic loading of one of the fixed address files 
(SYS1, SYS2, and SYS3), thus bringing the system up from one of the 
three levels of restart (see Section V.B). If the SIO Driver: 
package is to be used without the Executive, these functions must 

be modified, or appropriate programs must be placed in those files. 


The loader also has available another entry, ELOAD, described 
below. This entry allows the specification of the sector from 
which to start loading. As in the case of the other System 
Loader entries, the address of the first location loaded is 
immediately stored in location 3B, and JMP 3B,I is executed 

upon completion of the load, unless another address is specified 
in STRTA (see below). 


THE COMMUNICATION REGION 


The Communication Region is a set of locations referred to by 
other programs. They are gathered together into the area 
directly below the System Loader so that their actual octal 
addresses can be kept constant, despite any changes which may 
occur from time to time in the driver or loader programs. The 
following items make up the communication region: 


Vel 


LERR (X7537B). This cell has two uses. First, the System 
Loader uses it to indicate that there has been an error in 
loading the Executive or some other program. In this case, 
LERR is set to -l, and a transfer is made to X7544B to reload 
the system via a "cold start". 


The second use for LERR is for interpass loading. LERR is set 
to the address of the program name in core (three words contain- 
ing up to five valid ASCII characters, which are left-justified 
and zero-filled; this is preferably on the base page so that the 
Executive will not overlay it), and a transfer is made to X7549B 
to load the Executive, which in turn loads the named program. 


BTCHF (X7536B). This word specifies to the Executive whether 
control input is to come from the CK unit (on-line mode, 
BTCHF = @) or from the BC unit, (batch mode, BTCHF = -1). 


STRTA (X7535B). This word is used to pass a starting address 
to the loader. If this is set to zero, the starting address 
will be determined as explained above. Otherwise, the contents 
of STRTA will be used as the address to which to transfer after 
loading. | 


JSYST (X7534B). This word contains a jump to X7540B. 

PARAM (X7524B - X7533B). These locations are used for passing 

parameters between programs. The Executive Run command passes 

up to seven parameters according to the following convention: 
PARAM: Contains the number of parameters passed. 


PARAM+n: Contains the value of the n-th parameter. 


The Executive's interpass loader does not modify the parameter 
area, 


ELOAD (X7523B). This cell contains a jump to the generalized 
load entry point. A transfer to ELOAD with a sector address 
in the A register will cause one file to be loaded starting 
at that sector. Control will then pass to the loaded program 
as described above (see STRTA). 
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APLG (X7519B). This word is used by the SIO driver routines 
to indicate the type of binary data being processed. AFLG = 

191B for absolute binary; for relocatable binary AFLG = @. 

This must be set by the calling program. 


GSFLG (X7515B). This word is used by the Driver routines to 
control treatment of “group seperator" (Form Feeds and the 
Extra Paging Character). If GSFLG = @, then group seperators 
are not passed to the calling program; if GSFLG # %, then 

group seperators are treated the same as other characters. 
GSFLG is normally set to zero by the Executive before executing 
a Run command. 


P.FDT (X7521B). This cell contains the address of the functional 
device table. This is a table used by the driver in processing 
references to functional devices. . 


P.PDT (X7529B). This cell contains the address of the physical 
device table. This table is used by the driver to store informa- 
tion about the availability and capabilities of the physical 
devices supported by the system. 


P.DIO (X7522B). This cell contains the address of DIO, the: 
"system" entry to the FDOS I/O driver (see Section IV.C.1). 


P.CIO (X7512B). This word contains the address of the CIO 
(Custom SIO) entry to the driver. The program may provide it- 
self with SIO style calls (A = count, B = buffer, JSB, return to 
following location) and implicit commands (see Section IV.C.2c). 


P.XIO (X7517B). This cell contains the address of XIO, the 
"tailored" entry to the driver (see Section IV.C.2b). 


NLOGU (X7513B). This word contains the negative of the number 
of Logical Units for FDOS (four per drive). 


NBUFS (X7514B). This word contains the negative of the number 
of buffers allocated to the FDS driver. NBUFS is established 
at Sys-Gen time (see Section V.F.14). | 


Data is stored on disk in fixed, 128-word blocks (sectors); this 
is a basic hardware characteristic of the disk. From a soft- | 
ware standpoint, data must be transmitted in record-oriented form; 
record length, however, is variable (usually approximately 36 or, 
60 words -— see Section II.C). Therefore, the FDS Driver uses no 
relationship between records and sectors; rather, data are read 
from or written to disk in sector blocks, using core-memory buf- 
fers to parse out records or accumulate records. Operation of 
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the sector buffering is transparent to the user; if a record 
starts in one sector and continues to another, the next sector 
is managed automatically. 


The buffers are pooled and shared, and hueristically assigned 
and used. The greater the number of buffers available for 

disk usage, the less overlap in the usage; therefore, the num- — 
ber of disk accesses is decreased and thruput is increased. 

Since each buffer requires 129 words of core, a balance between 
the number of buffers and the amount of available memory must 

be determined for optimum operation; the minimum number of 
buffers is two, and the maximum is fourteen (see Section V.F. 14). 


It should be noted that the assignment hueristics allow data to 
accumulate in the buffers. It is the purpose of the ZS command 
of the Executive to clear out these buffers before switching 
disks so that sectors from the old disk, which are kept in core, 
are not interpreted as being from the new disk. ; 


FDOS DRIVER CALLS 


1. The FDOS "system" driver entry is DIO. The calls to DIO 
have the following form: 


JSB P.DIO,I 
DEF TABLE ADDRESS OF ARGUMENT TABLE | 
(returns here with A & B set per IV.C.1d) 


“P.DIO DEF X7522B,I POINTER IN COMM. REGION TO DIO 


TABLE ABS (command)SPECIFIES OPERATION AND DEVICE 
NUMB DEC (count) SAME AS SIO (A) SETTING FOR TRANSFERS 
BUFF DEF (address)SAME AS SIO (B) SETTING FOR TRANSFERS 


la. The Command word specifies the Sper eruee in bits 9 ee 6; 
these are coded as follows: 


CODE OPERATION © 

O50) Skip to start of next file 
O1 Rewind 

g2 Read a record 

G3 Write a record . 
g4 Write an End-of-File =~ 
g5 Name Hookup 

g6 Verify 


Iv-4 


Q7 (reserved) 


1g (reserved) 

11 (reserved) 

12 Skip a record 
13 (not used) 

14 (not used) 

15 Sense 

16 (not used) 

17 (not used) 


The Device is specified in bits 5 thru @ (see Table II-1). Bits 
14 thru 18 may be used to specify line counter/page character 
as in the Functional Device Table (FDT). Bit 15 must be zero. 


lb. The Count word specifies the number of operations or the 
amount of data: 


For skip operations, specifies the number of files 
or records to skip; use a positive count for ASCII 
data, and a negative count for binary data. 


For Rewind, WEOF, and Sense operations, count is 
ignored. 


For transfer operations, count specifies that length of 
data to be output or buffer available for input. If 
negative, it is minus the number of 16-bit words. If 
positive, it is the number of 8-bit ASCII characters. 


If ASCII is specified (positive A on call), records 
are read up to the carriage return and line feed codes 
These codes are also written at the end of each ASCII 
record output. They are not transferred to the buffer 
on input, and they are not counted in determining the 
total number transferred on either input or output. If 
an odd number of characters is read, an extra: space is 
supplied to fill out the last word. 


If binary is specified (negative A on call), data 
words are written from or read into ascending core 
addresses with the high order half-word correspond- 
ing to the first character input or output for that 
word. If an odd number of characters is read in a 
binary read, an extra zero is supplied. 


For Name Hookup, a code to specify the type of positioning; 
@ = disk file name, -l = a numeric positioning, such as a 
cassette file number. 
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le. For transfer operations, the Address word specifies the address 
of :-the buffer. On Name Hookup, the Address specifies the address of 
the name (3 words) or the address of the number (1 word). 


ld. On return from the DIO call, the contents of B contains the 
physical device number (see Table II-1), and the contents of A is 
set as follows: 


(A) 


1 for successful skip, rewind, write, 
write EOF 


(A) = number of words or characters for 
successful read 


(A) = @ if file mark detected 


ERRORS: (A) = -l if not ready 


(A) = -2 if write locked 
(A) = -3 if end-of-tape while reading 
(A) = -4 if error status while writing 
(A) = -5 if sees status while reading 
(A) = -6 if end of tape while writing 
(A) = -7 if format error on FDS (wrong name in file) 
(A) = -8 if nonexistent device* 
(A) = -9 if illegal device reference 
(A) = -1@ if nonexistent command 
*Non-existent device, physical device 17B (A = -8, B = 17B), 


means FDT assignment loop. 


~ 


NOTE: If an error occurs and bit 15 of B is set, a drive related error 
has occured (not related to a logical unit such as disk full, format 
error, or write protected) and bits 5-f are coded as for a logical unit. 


2. Other FDOS Driver entries are SIO, XIO, and CIO. To use 
any of these entries, a JSB to it should be made with the 
following register contents: 


(A) = count (see Section IV.C.1b) 


(B) 


address of buffer (see Section IV.C.1c) 
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Successful return is made to the location following: the JSB, with 
the following register settings: 


(A) 


i 


one for successful Skip, Rewind, Write or WEOF 
Operations; 


(A) = zero if file mark detected; or 


(A) = number of words or characters transfered for 
read operation. 


(B) = physical device number used for operation (see 


When these entries are used, error halts occur, as opposed to 
status returns as in DIO. These error halts are: 


HLT 618 Device not ready. 

HLT 62B Device write locked. 

HLT 63B End of ais ae read. 

HLT 64B Error during write. 

HLT 65B ‘Error atetay read. 

HLT 66B End of tape during write. 
HLT 67B Disk format error. 

HLT 7QB Non-existant device. 

HLT 71B Illegal device reference. 
HLT 72B Non-existant command. | 


When these halts occur, the registers are set as follows: 
(A) = address of call 


(B) = physical device used (see Table ITI-1). If bit 15 is 
set, then bits 2 and 3 define the drive used when 
accessing the disk directly (without using disk 
logical units); bits 2 and 3 = $B define drive D, 
1B define ‘E, = 2B define F, and = 3B define G. 


Pressing RUN will cause the command to be re-executed. Multiple 
record or file skips will re-execute the entire number, even if 
one or more has already been skipped. | 


2a. Standard Hewlett-Packard software, which uses SIO driver 
calls, makes use of fixed locations in. memory: . 


1@1B 
182B 
193B 
1f4B 


105B 


1Z6B 


173 


P.RE 


P. LW 


PMT 


Address of SIO input entry 
Address of SIO list entry 
Address of S10 output entry 
Address of SIO keyboard entry 


First word address of available 
memory 


Last word address of available 
memory 


A flag used by HP MTS (not usable in FDOS) 


The Dicom combined SIO driver package sets all of these (except 
P.FW, which is normally set by individual programs)as follows 
(see entry names above): 


1918 
1@2B 
103B 
1@4B 
1@6B 


1873 


PMT 


DEF 
DEF 
DEF 
DEF 
DEF 


NOP 


STO.I (uses DI) 
SIO.O (uses PL) 
SITO.P (uses DP) 
SIO.K (uses PK) 
(last word before driver package) 


(not usable - must be @) 


The SIO calls have implicit commands associated with them; 
that is, read or write on functional units. 


2b..The XIO calls allow explicit commands to be used, but are 
treated like SIO calls rather than DIO calls in regards to errors. 
The XIO calls are of the form: 
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LDA (count) 
LDB (address) 
JSB P.XIO,I 
ABS (command) 
(return) 


P.XIO DEF X7517B,I POINTER IN COMM. REGION TO XIO 
The command may be any valid command (see Section IV.C.la). 


2c. The CIO calls also allow explicit commands to be used, but 
are of a double subroutine level; the outer level uses implicit 
commands. Errors are treated in the SIO fashion as explained 
above. The CIO calls are of the form: 


LDA (count) 
LDB (address) 
JSB SIO. U 
(return) 


SIO.U NOP 
JSB P.CiIO,T 
ABS (command) 


P.CIO DEF X7521B,I POINTER IN COMM. REGION TO CIO 


Note that no return is needed from the SIO.U routine; if an error | 
halt occurs, then the A Register will contain the address of the 
JSB SIO.U. However, SIO.U must be exactly three words long (entry 
JSB, and command). ABS can be any legal command; see Section © 
Iv.C.la. 


3. Utility commands exist within the combined driver. A command 
of minus one causes all the sector buffers to be cleared (see | 
Section IV.B); this is what occurs when the Executive's ZS command 
is used. This clearing of buffers should be accomplished prior to 
removing a cartridge from a drive, thus removing holdover sectors 
from the buffers. 


It should be noted that even though the address word (B in the 


SIO/XIO/CIO calls, or table entry three in DIO calls) is not used, 
it is evaluated, and therefore must not cause an indirect loop. 
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IV.D. 


Other utility commands (negative value command word) exist in 
the combined driver; the user is refered to the listing of the 
driver for these. | . 


FDOS DRIVER OPERATIONS 


The action and idiosyncracies of the SIO/XIO/DIO/CIO commands and 
devices are as follows: 


1. Skip to start of file, octal Y+UNIT; skips past the number of 
End-of-File marks specified by the count. On file-oriented devices 
(disk or cassette) this is done by moving over files, but on paper 
tape type devices the data must be read to determine the End-of-File 
marks; therefore, the count must specify the mode (positive for 
ASCII, negative for binary). The sign of the count has no effect 

on a file oriented device. 


A count of zero results in no action being taken: If an error halt 
occurs, continueing will cause the entire number to be skipped 
again. If, on a paper tape type device, a multiple file skip is 
done and an intermediate End-of-File mark consists of over 20 nulls, 
then the first ten constitute the BOF and the subsequent group of 
ten nulls are ignored until a non-Null character is found. However, 
if the last file mark of the skip consists of over 20 nulls, the 
skip ends when ten are found, and a subsequent read (without manual 
intervention) will find ten more, resulting in an EOF (most programs 
ignore an initial EOF). A device must have input capabilities to 
do a skip; the Address parameter is ignored. 


2. Rewind, octal 1@@4+UNIT: on a file-oeiented device (disk or <: 
cassette), positions to in front of file #1. On paper tape type 
devices, executes a HLT 6@B (even if a DIO call) to allow manual 
intervention before continuing. | 


A device must have input capabilities to do a rewind. On disk, 
even if no files are in the LUD, there is no End-of-Tape indication 
(until some forward movement is given). The count and the address 
parameters are ignored. 


3. Read a record, octal 2@@+UNIT; reads’ a record in the specified 
mode into the specified buffer of a specified length, one character 
at a time. The Address word may be indirect. The count must be 
positive to indicate the number of ASCII characters, or negative to 
indicate the number of binary words. Characters are intrepreted as 
they are read. In binary, only the first character, as the record 
length; in ASCII, all characters as to meaning (Nulls ignored, 
Rubout deletes line, Return ignored, Linefeed ends record, CNTIRL/H 
deletes preceeding character of line, Extra paging character con- 
verts to Formfeed, Formfeeds ignored or passed according to GSFLG). 


If the buffer address is zero, then the count is ignored and no 


data is transmitted to the user (this is a skip one record); other- 
wise, if the count is zero, no action takes place and A is returned 
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as 1. Reading continues until a record containing some data,is 
found. If a record is larger than the specified buffer length, 
then the extra characters are not transmitted and input continues 
to the end of the record (to leave the device properly positioned 
for the next record). Finding a physical EOF (on file-oriented 
devices) or finding ten Nulls at the start of a read operation is 
interpreted as EOF (file oriented devices are always left past the 
physical EOF). If an odd number of characters is read in a record, 
the last word of the buffer is filled with a zero if binary, or a 
space if ASCII (although the space is not included in the count 
returned). In ASCII, if a Linefeed is not preceeded by a Return, 
or a Linefeed, then a Return is echoed if appropriate for the 
device (i.e., on TTY, and Deck Zero). A device must have input 
capabilities to do a read. 


4, Write a record, octal 3QM+UNIT; transfers the specified number 
of words or characters from the specified address in the specified 
mode, or does a format control to the device. In binary transfers, 
the count is the negative number of words, and those words are 
transfered with no processing, but some (physical device dependent) 
processing is done at the end of the record - paper tape type have 
four Nulls following, cassette has a physical end-of-record 
following which signifies logical end-of-record on binary input, 
disk has no processing (and records could theoretically be 
concatenated). 


In ASCII transfers, the count is the positive number of characters, 
and these characters are transferred (except for nulls and except 
for the last character if it is a backarrow). A Return and Linefeed 
are output unless the last character of the record is a backarrow. 
If the Return and Linefeed are output and a line count is being kept 
(and the count goes to 6%) then the specified paging is done for 

the device and the line counter is reset. 


In format control, a zero count always means output a Return and a 
Linefeed. If the device is a list-capable unit, then the negative 
count means formatting rather than binary. A minus one means top | 
of form. All other negative values are ignored. Format control 
ignores the address parameter. A device must have output capability 
to do a write. 


5. Write an End-of-File, octal 4Q8G+UNIT; on a file-oriented device, 

a physical End-of-File is written and, on disk, the unit is positioned 
to the begining of the next file. On the lineprinter, two pages are 
ejected. On paper tape type devices, if it is a list-capable device, 
a Formfeed, a Rubout, and a Linefeed are output followed by, or if 

a binary device, only, 22 nulls (to allow for over ten nulls and 
tear-off space on Low-speed Tape, or to allow time to tear off the 
page on TTYs), and, if High-speed Tape, 1%@ nulls for leader/ 

trailer. A device must have output capabilities to do a WEOF. 


6. Name Hookup, octal 59M+UNIT; passes to disk logical unit a 
name. The count parameter must be zero (a flag) and the address 
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points to the name (up to five valid ASCII characters, left- 
justified and zero filled in three words). The logical unit i-:7- 
temporarily remembers the name, and, with the next access, proceeds 
with that file (randomly accessed via the Disk Directory) as if it 
had been in the LUD at that point. The name is not remembered 
after the first motion access to that logical unit, but the logical 
unit will be in the file until it leaves for some reason (Rewind, 
Skip, WEOF, or EOF read, etc.). If the logical unit leaves the 
logical unit at the EOF (rather than a Rewind) it will be positioned 
as it was before the Name Hookup, unless it was in-a file, in which 
case it will be at the begining of the following file. 


The Name Hookup command provides for a number to be passed (count 

= -1, address points to number) for count-selection type purposes 

in other type devices. A device must have disk command capabilities 
to do a Name Hookup. 


7. Verify a record, octal 6YG+UNIT; a record is read into core 
(under the same conditions as read) and, character-by-character on 
the fly, if it differs from what was there the verify fails. A is 
returned as 1 if all characters were the same, and is zero if any 
characters differed. The new characters are in the buffer. 


This command is not expected to be used with ASCII records contain- 
ing Rubouts or CNTRL/H, as the buffer and the success/fail have 
already been affected by the deleted chatacter(s). 


8. Skip record, octal 12Q@+UNIT; the specified number of records 
are read (under the same conditions as read) in the specified mode, 
but no data is passed to the user. 


9. Sense device, octal 159@+UNIT; the status words returned as . 
defined: in Section III-H. 
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FDOS CONFIGURATION 


The FDOS software is shipped in both a "standard" configuration 
and a "skeleton" configuration. Thus, the user can configure 
his hardware per the "standard" software configuration and get 
the FDOS "on-the-air" immediately; or the user can use the 
"skeleton" portion and tailor the software for the memory size, 
interface channel assignments, and functional unit assignments 
that match his specific requirements. 


FDOS "STANDARD" CONFIGURATION 

The "standard" software configuration shipped can be installed 
per the "Installation of Software" appendix of this manual. 
This software configuration is as follows: 


Memory Size - 12K 


ChaconChannel Assignments - 
* 19B = FDS Data channel 


* 1J1B = FDS-Control Channel Paes 
* 12B = Console Device Interface channel (HP-interfaced 
teleprinter) 


* 13B = Photoreader Interface channel 

14B = Cassette System Interface channel 

* The Line Printer (if available) is attached to Physical 
Device zero (cassette system "deck zero") 


% 


Functional Unit Assignments - 7 

* Disk drive D as the "system library device" used by 
the Bootloader, system Loader, and the various eyeren 
processors 

* El as the SIO Input Unit (DI) used by the Executive 
default conditions (when applicable) and the various 
system processors 

* E2 as the SIO Output Unit (DP) used by the Executive 
default conditions (when applicable) and the various 
system processors. 

* E3 as the High Speed List Unit (HL) used by the various 
system processors 

* E4 as the scratch area (SC) used by the FORTRAN Compiler 
as temporary storage for the intermediate file (between 
pass one and two) 

* All keyboard units (CK, PK, and AK) assigned to the 
HP-interfaced Teletype (TY) 

* All low-speed list units (CL, PL, AL, and BM) assigned 
to the HP-interfaced Teletype (TY) | 


Auxiliary Input (AI) assigned to the photoreader 
Auxiliary Output (AP) assigned to cassette deck one 
Auxiliary Scratch (AS) assigned to cassette deck two 
Auxiliary High-speed List assigned to the cassette 
system "deck zero" (lineprinter) | 

Batch Command assigned to D2 

D4 as the library device for the Relocatable Banaey 
used by the Absolute BCS file 


ee e * 


+ + 


FDOS INITIALIZATION AND LOADERS 


The FDOS software makes available a number of different levels 
of restarts and initializations in order to accomodate the 
varying needs of users and software packages. The FDOS 
software is supplied on a "skeleton disk" which contains seven 
files (designed specifically to facilitate startup procedures) 
plus the other FDOS program files. The seven specific files 
are: : 

The unconfigured Bootloader 

The configured System Loader 

The "Skeleton" file (SYSQ@) 

The "cold start" file (SYS1) 

The “warm start" file (SYS2) 

The "Executive" file (SYS3) 

The "System Map" file (SYSM) 


FF HF be HF 


‘1. The unconfigured Bootloader is designed to be loaded by 


the Keyed-In Loader (see Section V.C). Once the unconfigured 
Bootloader has been loaded, it can be configured for channel 
assignments and memory size, and the configured Bootloader 
moved to the protected area of memory (see Section V.D). 


2. The "Skeleton" file (SYS@) contains the unconfigured System 
Loader, unconfigured SIO Driver package, unconfigured Exec- 
utive, and the System Generator. Special precautions are 
taken in the FDOS software to protect this file (see Section 
VI.F.2); thus, it is always available to the user for use 
in building a new FDOS software configuration. 


3. The configured System Loader resides in sector zero of 
the disk, and is normally loaded via the configured Boot-— 
loader. The System Loader is the "core resident" portion 
of FDOS. On the "skeleton disk" shipped from the factory, 
the System Loader is configured per Section V.A; when the 
configuration (see Section V.F) is performed, a new System 
Loader is written in sector zero. | 


The "System Map" file (SYSM) contains a listing of all 
peripheral device channel assignments, all functional unit 
assignments, and other system configuration details. 

This file can be printed on the Teletype with the following 
command string (see Section VI.F.2): 


SE;TQ D1,SYSM;LI D1,CL 


Section V.G shows a printout of SYSM for the "Standard" 
software configuration. The Functional Unit assignment 
portion of the System Map can be printed directly with 
the List All units (LA) command. 


The three remaining files (SYS1, SYS2, and SYS3) contain 
the configured (per Section V.A) FDOS software system;. 
when the system generation is performed, a new software 
system is written into these files. Special precautions 
(see Section VI.F.2) are also taken here, so the System 
Generator is the only package that can noeiahy write in 
these files. 


Track zero of all disks is reserved for system control 
information (directories, etc.); the various "system" files 
start and/or reside on track zero. This track is allocated 
as follows: 
Sector “@ Configured System Loader 
Sector 1 Disk Directory 
Sector 3 Unconfigured Bootloader 
Sector 4 Logical Unit Directory, unit 4 
Sector 5 Logical Unit Directory, unit 1 
Sector 6 Logical. Unit Directory, unit 2 
7 Logical Unit Directory, unit 3 
3 Starting Sector of the "System Map" 
file (SYSM) 
Sector 14 Starting sector of the "Skeleton" 
file (SYSQ) . 
Sector 15 Starting sector of the "Cold Start" 
file (SyYS1) 
Sector 16 Starting sector of the "Warm Start" 
file (SYS2) 
Sector 17 Starting sector of the "Executive" 
file (SYS3) 
All other sectors of track zero (sectors 2,10,11, and 12) 
are reserved for expansion. The remaining disk area 
(tracks one through 64) is used by the remaining FDOS pro- 
aeenae or is available to the user. 


Sector 
Sector 1 


figured Bootloader from sector three of disk D. 
.Loader is designed to be as short as possible, 


FDOS KEYED-IN LOADER 


The FDOS Keyed-In Loader is a program used to load the uncon- 

The Keyed-In 
Since it is 
intended to be entered from the front panel of the computer. 
Since the unconfigured Bootloader is in a special format, it 
must be,loaded with the Keyed-In Loader; the Keyed-In Loader 
cannot be used for loading any other file from disk. 


To commence the configuration process, enter the Keyed-In 
Loader shown below (refer to "A Pocket Guide to the 2100 


Computer" or to "A Pocket Guide to Hewlett-Packard Computers"); _ 


then configure the remainder of FDOS per Sections V.D and V.E. 


* FDOS KEYED-IN LOADER 
* 
* THIS PROGRAM LOADS THE UNCONFIGURED BOOTLOADER INTO MEMORY 
* (STARTING AT LOCATION %76%0B) AND HANGS. WHEN THE PROGRAM 
* IS STARTED, THE DISK WILL CLICK; THE UNCONFIGURED BOOT- 
x LOADER IS IN CORE 'INSTANTLY'. PRESS HALT. NOW CONFIGURE 
* THE BOOTLOADER PER SECTION V.D. 
* 
B2LLS ORG 29293 
* 
G208H8 1G31pc START CLF DAT MAKE SURE FLAG IS CLEAR 
G2GC1 G62G14 LDA READ READ COMMAND 
G2GG2 S66G15 LDB CORE ADDR TO LOAD INTO 
02803 19826cc OTA CMD SEND 
02904 1037cc STC CMD,C THE COMMAND 
02885 1823pc LOOP SFS DAT WAIT FOR 
P2906 G26GG5 IMP *—1 DATA FLAG 
020887 1025dc LIA DAT INPUT A WORD 
$2918 1837pc STC DAT,C ACKNOWLEDGE 
C2011 17081 STA B,I STORE WORD 
P2912 PPogsa INB BUMP STORAGE POINTER 
G2G13 G26GG5 JMP LOOP GET ANOTHER WORD 
Q2G14 Y29883 READ OCT 29803 DISK D, SECTOR THREE 
$2815 BO76GHP CORE octT 7699 
* 
* 
* DC IS THE DATA CHANNEL (NORMALLY 1B) 
* CC IS THE CONTROL CHANNEL 
* 


FDOS BOOTLOADER CONFIGURATION 


The FDOS Bootloader is designed to load the configured System 
Loader from sector zero of disk D; it has a second entry that 
can be used to load any absolute file from disk D whose initial 
sector address is contained in the Switch Register. The Boot- 
loader is supplied on the "skeleton disk" in sector three; 


it is not configured. 


1. To configure the Bootloader, enter the Keyed-In Loader 
(see Section V.C) and place the "skeleton disk" in drive 
D. Preset the computer, then start the Keyed-In Loader 
at @29G9GB to load the unconfigured Bootloader and its 

Halt the computer, then restart it at 

G7690B; the configurator program will come to a series 


configurator. 


of halts: 
HLT 


HLT 


HLT 


HLT 


74B 


75B 


76B 


77B 


Enter the disk data channel in the 
Switch Register (normally 1B) and 
press RUN. 


Enter the disk control channel in the 
Switch Register (normally the lowest 
priority channel, although it can 

be of higher priority than any 
asynchronous device) and press RUN. 


‘Enter the memory size mask (X779@B) | 


in the Switch Register, enable the 
loader area, and press RUN. The 
Bootloader will be configured and 
moved to X77@@B, i.e., the protected 
area of memory. Use X = 1 for 8K, 
2 for 12K, 3 for 16K, etc. 


Configuration complete; protect the 
loader area. 


2. The configured Bootloader has two entry points: 


X770GB 


X771B 


Load a file from disk D, sector zero; 
this is normally the configured 
system Loader. 


Load a file from disk D whose initial 
sector address is contained in. the 
Switch Register. (If using a 2114, 

the LOADER ENABLE switch on the inside 
of the front panel must be in the ON | 
position to start at location 17791B.)_ 


we A 


After execution at either of these entry points, the Boot- 
loader will-halt with the P Register equal to 2B; if the 
configured System Loader was the file loaded, it can be 
executed by just pressing RUN. This is possible, since 

the System Loader (as it is being loaded by the Bootloader) 
sets location 2B to a jump indirect through 3B, and sets 
location 3B to X7544B (the "cold start" entry point); upon 
successful loading, the Bootloader halts with the P Register 
set to 2B. Since most absolute program files also set 
locations 2B and 3B in this manner, this feature can be used 
to load and execute those files. 


FDOS SYSTEM LOADER 


The System Loader is intended to remain in memory at all times. 
When not resident in memory, it can be loaded by the protected 
Bootloader. The System Loader has three entry. points: 


X7549B Standard Exec reload; load the file starting 
at sector 17B. This entry is used by the 
ASMB, EDIT, CROS, etc., programs. It leaves 
the SIO area, Communications Region, Logical 
Unit Parameter Tables, and buffer status intact. 


X7542B Load the file starting at sector 16B, the 
"Warm start"; the SIO and Communications 
Region are reloaded, and a transfer to X754@B 
is made to reload the Exec. The Logical 
Unit Parameter Tables and buffer status tables 
are left intact. This is intended to restore 
the original SIO configuration after a 
temporary reconfiguration. 


X7544B Load the file starting at sector 15B, the 
"Cold start"; this is intended to be used when 
the contents of memory can no longer be counted 
on, such as after a program which.:does not 
preserve the SIO area has been run. This 
start must be used if the system ever "crashes". 
This start initializes the Logical Unit 
Parameter Tables and the buffer status tables, 
and transfers to X7542B for a "warm start". 


On the "Skeleton disk" shipped from the factory, the System 
Loader is configured per Section V.A.; when the configuration 
(see Section V.F) is performed, a new System Loader is written 
in sector zero. 


FDOS "SKELETON" CONFIGURATION 


The "skeleton" file (SYS@) contains an interactive System 
Generator section, the unconfigured SIO Driver, the uncon- 
figured System Loader, and the unconfigured Executive. When 
SYS@ has been loaded and executed, the user can tailor FDOS 
to a particular hardware configuration, memory size, unit 
assignment, etc. This is accomplished by typing responses 
to questions asked by the System Generator; after the con- 
figuration parameters have been entered and verified,the 
System Generator (optionally) writes a configured FDOS 
software system into SYS1, SYS2, SYS3, and SYSM of disk D. 
It should be noted that this System Generator can be used to 
prepare an FDOS disk for a computer system with a different 
hardware configuration from the one it is being run on; the 
only restrictions are that the current system has at least 
as much memory as the target system, that the disk data and 
control channels are the same on both systems,:and' that’ the 
console device has the same channel number on both systems. 


Following is the configuration procedure: 
1. Bootload SYS% using the X7791 entry of the Bootloader. 
with the Switch Register set to 14B. To execute the file after 


such a load, press RUN; the computer will execute a HLT 5@B. 


2. Set the Switch Register to the channel number of the console 
device (functional units CK and CL); if the console device 

is interfaced thru the cassette system deck zero, set bit 15 
also. Press RUN. 


3. The program types 
SYSTEM ID: 


requesting up to sixty characters of ID information to be used 
to label the resultant configured disk. This ID information 
will be written in the System Map (SYSM) file if "write 

system to disk" is specified later on in this system gener- 
ation procedure. 


NOTE: Responses to questions are terminated by Carriage 
Return-Line Feed. If an error is made in answering 

the questions in Step 4 and beyond, the System Generator 
can be restarted at Step 3 by typing "ER". The valid 
responses are "NO" to indicate that the device is not 
available, a two-digit octal number defining the device's 
channel number, or responses defined in the descriptions 
below. 


4. If bit 15 was not set in Step 2 above, the program 
types 
TELETYPE CHANNEL: CC 


~where "CC" is the two digit octal number that was entered 

in the Switch Register in Step 2 to define the HP-interfaced 
Teletype channel. If an HP-interfaced Teletype was not 
defined in Step 2 (bit 15 set), the program types | 


TELETYPE CHANNEL? 


requesting the HP- interfaced Teletype channel number. 
Reply appropriately. 


5. The program types 
USES PAGING OPTION? 


requesting the option to be used to format printed pages 

on this Functional Unit (CL)... Respond by typing "L" for Line- 
Feed, "F" for Form Feed, "N" for no page spacing, or "x" 

for the Extra Paging Character (see Step 18). a. 4 * 


6. The program types 
HAS LOW SPEED TAPE? 


thus asking if the HP-interfaced Teletype is to be used for 
paper tape input or output. Reply by typing "YES" or "NO". 
Lf "YES" is typed, the program types 


PUNCHING AND PRINTING SEPARATE? 
thus asking if the HP-interfaced Teletype is an ASR33 or ASR35. 
Type "NO" if ASR33; type "YES" if ASR35. If an ASR33 is defined, 
then under normal FDOS operation the computer will halt (HLT 56) 
before outputing to the ASR33 paper tape punch to allow the oe 
operator to turn on the punch; when punching is complete, the 


computer will halt (HLT 55) to allow the Cpe acon to turn the 
punch off. 


Se or er 


7. #=The program oe eas 
HIGH SPEED PUNCH CHANNEL? 


requesting the high-speed paper tape punch channel number. 
Reply appropriately. 


8. The program types — 
HIGH SPEED READER CHANNEL? 


requesting the channel number of the photoreader. Reply 
appropriately. . 


9. The program types 

LINE PRINTER CHANNEL? 
requesting the line printer channel number; reply appropriately. 
The SIO Driver supports the HP 2767 (Data Products) or 2607 


(Tally) printers; for the HP 2778 (CDC) or other non-compatible 
printers, the driver must be slightly modified. 


10. If bit 15 was set in Step 2, the program types 
CMTS CHANNEL: CC 
DECK ZERO EXISTS 
HAS INPUT CAPABILITY 
USES PAGING OPTION? 


where CC is the channel number defined in Step 2. The re- 
sponse to the paging option question is the same as in Step 5. 


ll. If bit 15 was not set in Step 2, the program types 
CMTS CHANNEL? 
requesting the cassette system channel number. If "NO" is 
typed, the program proceeds to Step 12. If "YES", the program 
types 
DECK ZERO EXSISTS? 
asking if a device (TTY, CRT, line printer, etc.) is inter- 
faced to the computer via deck zero. If "YES" is typed, the 
‘program types 


HAS INPUT CAPABILITY? 


asking if the device has a keyboard on it. Reply appropri- 
ately. The program types 


USES PAGING OPTION? 


The response to the paging option question is the same as 
in Step 5. 


12. The program types 

FLOPPY DISK DATA CHANNEL? 
requesting the FDS data card channel number. Since this 
must be defined, a "NO" response causes the question to 
be re-asked. 
13. The program types 


FLOPPY DISK CONTROL CHANNEL? 


requesting the FDS control card channel number. A "NO" 
causes steps 12 and 13 to be repeated. 


14, The program types 
NUMBER OF BUFFERS? 


Reply appropriately (see Section IV.B ). For optimum 
operation in an 8K system, three buffers are recommended; 
in 12K or larger systems, four buffers are recommended. 
15. The program types 
NUMBER OF DRIVES? 


Reply appropriately (one to four), depending on how many 
drives are implemented in the FDS. 


16. The program types 
DISPLAY DISK COMMANDS? 


inquiring as to whether disk commands are to be displayed in 
the Switch Register during FDOS SIO operation; reply appropri- 
ately. Commands are not displayed during BCS operation. 


17. The program types 


FUNCTIONAL UNIT ASSIGNMENTS: 
> 


At this point the operator may change the physical unit vs. 
functional unit assignment for a particular configuration of 
hardware. Until some experience has been gained, it is 
recommended that the user respond with only. "/E", to cause 
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the standard assignments that have been assembled into sys-gen to 
be used. To change the Functional vs. Physical Unit assignments, 
use the format FU,PU,LC,PC (see Section II.B). Typing "A?" will 
list the entire FDT; "/E" terminates and moves on to the next step. 
Restarting without reloading ("ER" input) does not restore the FDT. 


18. The program types 

EXTRA PAGING CHARACTER? 
Unless the system has a list device that is capable of responding 
to a page-spacing character other than Linefeed or Formfeed (such 
as Vertical Tab), it is sufficient to respond "NO". Otherwise, 
respond with a two-digit octal number representing the ASCII 
character desired. | 
19. The program types 

CORE SIZE (IN K)? 
Reply appropriately. 
20. The program types 

WRITE SYSTEM TO DISK? 


Reply "YES" if it is desired to write this newly configured 


system to disk (in SYS1, SYS2, SYS3, & SYSM) later on in this - -. -... 


program. 
21. If "YES" was typed in aia 20, the program types 
FORMAT DISK? 


inquiring as to whether a Format Disk command to drive D is 
desired. Type "YES" if there is a virgin disk in drive D. 


22. The program types 

CONFIGURATION MAP? 
Reply "YES" if it is desired to have one printed on the console 
device at this time; if "YES,unit" is typed, the map will be © 
written to the specified unit. 
23. The program types 

OKAY AS IS? 


If the configuration is as desired, type "YES". At this 
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point the unused portion of DIO (drivers for non-exsistent 
peripherals) is released and the system is configured in 
core. If the program was directed to write the system in 
step 20, SYS1, SYS2, SYS3, SYSM, and the configured System 
Loader are written onto disk D (see Section V.B), all of 
memory below X7534B is set to zero, and a "cold start" is 
made via a transfer to X7544B; if the program was not di- 
rected to write the system, a transfer is made to the 
Executive. If the configuration is. not as desired, EyPe "NO". 


24. The program types 
START OVER? 


If "YES" is typed, the program goes back to the "SYSTEM ID" 
question of step 3; if "NO" is typed, the program goes back 
to step 23. . 


25. The following error halts are applicable to the System 
Generator: 


HLT:31BoreThe value stored at the address displayed in 
the Switch Register did not hold (either non- 
existant memory, faulty memory, unattached or 
unplugged memory, etc.). Correct condition 
and press RUN, or reload pe end restart 
the System.Generator. 


HLT 32B The process of moving the system has caused 
| an over~lap of sections of relocatable code. 
This is a program safety check to insure the 
resultant system will fit in the available © 
memory; it is fatal and irrecoverable. 
Continuation will repeat HLT 32B. Reload 
SYS#-and.restart-the System Generator. ~ 


HLT 47B The processing of devices has caused an im- 
possible situation. Press RUN to restart the 
configurator. Theoretically, this can not 
happen} 


26. It is not necessary that the configurator write out the 
new system on the "skeleton" disk shipped from the factory; in 
fact, it is best if it does NOT, since this disk should always 
remain write-protected and used as the "master". The "skeleton" 
disk could have been replaced by any “ (virgin) disk after SYS# 
was loaded from it. However, if a freshly formatted disk is 
used to write the just-configured system onto, SYS@ (sector 14B) 
will be an empty file, but sector 14B will be preserved for the 
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initial sector of SYS@. This means that the "skeleton" file 
(SYS@) does not get written during the configuration process; 
however, the unconfigured Bootloader does get written into sec- 
tor three. The SYS@M file could be copied from the "master" 


disk after the configuration process if it were desired to 
have it on the "working" disks. The copying of SYS@ (plus all 
other files on the "master" disk) can be accomplished easily 
“withethe CODSK batch file; see the INSTALLATION OF SOFTWARE 


.. Appendix of.this~manual. 
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V.G. SAMPLE SYSTEM GENERATION PRINTOUT 


SYSTEM IDs: ; 
SAMPLE SYSTEM GENERATION PRINTOUT 


TELETYPE CHANNEL: 12 
USES.PAGING OPTION? N 

HAS LOW SPEED TAPE? YES 
PUNCHING AND PRINTING SEPARATE? NO 


HIGH SPEED PUNCH CHANNEL? NO 
HIGH SPEED READER CHANNEL? 13 
LINE PRINTER CHANNEL? NO 


CMTS CHANNEL? 14 | 

DECK ZERO EXISTS? YES 
HAS INPUT CAPABILITY? NO 
USES PAGING OPTION? N 


FLOPPY DISK DATA CHANNEL? 18 


FLOPPY DISK CONTROL CHANNEL? 11. _ 
NUMBER OF BUFFERS? 4 . 
NUMBER OF DRIVES? 2 

DISPLAY DISK COMMANDS? YES 


<<FUNCTIONAL UNIT ASSIGNMENTS: >> 
? SE ; 


EXTRA PAGING CHARACTER? NO 
CORE SIZE CIN K)? 12 


WRITE SYSTEM TO DISK? YES 
FORMAT DISK? YES 


CONFIGURATION MAP? YES 


SYSTEM IDs: SAMPLE SYSTEM GENERATION PRINTOUT — 


CMTS CHANNEL: 14 
- DECK ZERO EXISTS 
USES PAGING OPTION: N 
HIGH SPEED READER CHANNEL: 13 
TELETYPE CHANNEL: 12 
USES PAGING OPTION: N- 
HAS LOW SPEED TAPE . 


FLOPPY DISK DATA CHANNEL: 14 . 
FLOPPY DISK CONTROL CHANNEL: 11. 
NUMBER OF BUFFERS: 4 
NUMBER OF DRIVES: 2 
DISPLAY DISK COMMANDS 


SAMPLE SYSTEM GENERATION PRINTOUT (Continued) 


<<FUNCTIONAL UNIT ASSIGNMENTS: >> 


DI E1sB 

PL TELETYPEs@5L 
DP E2sB 

PK TELETYPEs@sL 
HL . ESs oF 

SC E4.B 


CK TELETYPEs@sL 
CL TELETYPEs@s5L 
AI HS TAPE>sB 

AL TELETYPEs:@sL 
AP 19B 

AK TELETYPEs@5L 
KH DECK ZEROs2sF 
AS 258 

BO D2sB 

BM TELETYPEs@sL 
S26 1658 

S21 1638 

S22 1658 

Sé3 1628 

S24 165B 

$25 163B 


S26 1698 


S27 1628 
S30 165B 
S31 16sB 
S32 165B 
S33 16.8 
S34 1658 
S35 169B 
S36 169B 
S37 1638 


CORE SIZE CIN K): 12 


FORMAT DISK 
WRITE SYSTEM TO DISK 


OKAY AS IS? YES 
* 
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SAMPLE SYSTEM 


*DA D 


FREE e 


‘SYSO 
SYS1 
SYS2 
SYS3 
SYS™ 
SRCE 
FSRC 
LIBN 


LIBE 


LIBF 
CODSK 
EDI T 


ASMBN > 


CROS 
FORT 
FOREN 
DUP . 
DEBUG 
EXER 
ABCS 
DPCS 
De 36 
De 3 6X 
DAO 
De35 
TOC. 
RLOA 
SD3 6% 
ASMBE 


| ASMBF 
yee 


es 
KK 


OK 


He ote 
oe 
5 es 
*K 
kek 
*K ok 
* 
* 
* 


OK 


RK 


ok 
kk 


** OK 
4x 
KR 
KK 
a ok 
OK 


eK 


KK 
2 AK 
4k 
2 
KS 
aK 
ee 


ARK 


aK 


GENERATION PRINTOUT (Continued) 


el 
ADDRESS OF FIRST FREE SECTOR - . 
UNCONFIGURED BOOTLOADERs SIO PACKAGEs AND EXECUTI VE- 
“COLD START FILE 
“WARM START FILE 
STANDARD EXECUTIVE RELOAD 


SYSTEM MAP 


DEMO PROGRAM SOURCE (ASSEMBLY LANGUAGE) 
DEMO PROGRAM SOURCE (FORTRAN) 
NON-EAU MATH LIBRARY . | : 

EAU MATH LIBRARY 

FLOATING POINT MATH LIBRARY 

BATCH FILE FOR COPYING MASTER DISK | 
EDI TOR 

NON-EAU ASSEMBLER | 
CROSS-REFERENCE GENERATOR 

FORTRAN PASS ONE 

NON-EAU FORTRAN PASS TWO 

DISK UTILITY PACKAGE 

SIO ENVIRONMENT DEBUGGER 

FDS. DIAGNOSTIC 

CONFIGURED BCS FILE 

DISK PREPARE CONTROL SYSTEM 

FDS BCS DRIVER | 

FDS BCS DRIVER EXTERNALS 

TTY BCS DRIVER © 

CMTS BCS DRIVER 

INPUT/OUTPUT CONTROL. 

RELOCATING LOADER 

SOURCE OF FDS BCS DRIVER EXTERNALS 
EAU ASSEMBLER 

FLOATING POINT ASSEMBLER 


2eRUZ Eee ENG POINT FORTRAN PASS TWO 


“¥LD DisLD D23LD D33LD Da: 


Dis 

SRCE 
FSRC 
SD3 6% 


De: 


CODSK — 


D3 

De 36 
De 36X 
De AD 


Deas: 
-L0C~ 


RLOA 


DA: 

LIBN 
LIBE 
LIBF 
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FDOS EXECUTIVE COMMANDS . 


A summary of the Executive commands appears in an appendix 

of this manual. When the Executive is ready for a command, 

it types "*" on the console device, rings the console device 

bell, and waits for a command line to be entered. A command 

line consists of one or more commands, each, except the last, 
terminated by a semicolon. A command consists of a two-charac- 
ter command code, optionally followed by a space and a variable 
number of parameters, each, except the last, followed by a comma. 
If a given command can accept parameters but not all are supplied, 
the Executive supplies "default" values for the missing ones. 


The parameters for a given command must be supplied in a 
fixed order. If it is desired to omit (i.e., use the de- 
fault value for) a given parameter but specify some or all 
of the following ones, simply type the comma which would 
normally follow it, but with no non-blank character between 
it and the comma following the previous parameter, if any, 
or the blank following the two-character command code. 

For example, 


COs 42 


requests the Executive to perform a copy function using 
default values for the first, second, and fourth parameters 
and the value "2" for the third parameter (in this example, 
two files of data are copied from DI to DP in the ASCII mode). 


Several commands may be typed on one line (or placed in one 
record) by separating them with semicolons. For example, 
if it were desired to skip two files on logical unit El, 
copy the third file (in absolute binary format) from El 
onto cassette deck two, write an end-of-file on deck two, 
and then rewind deck two, the following command sequence 
would be used: 


SK El,2;CO El,2,,BA;WE 2;RE 2 


An important feature of FDOS is the handling of the Batch mode. 
Operation in the Batch mode of the Executive differs from normal 
on-line operation in that command lines are taken from the Batch 
Command unit (BC), and messages, including the actual command 
strings, are sent to the Batch Message unit (BM). Batch command 
lines can be intermixed with data input if BC is set to the 

same unit as DI (see example under Write command! and the CODSK 
batch file in the INSTALLATION OF SOFTWARE Appendix). 
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VL.A. 


VI.B. 


VI.C. 


The Batch mode is entered via the Batch command (BA). The 
Executive remains in the Batch mode until one of the following 
occurs: 


* WR Batch Exit command is received from BC. 
* An EOF is detected on BC. 
* An I/O error is detected. 


In addition to the standard HP feature of RUBOUT deleting 
(via the SIO driver) the current ASCII epee line, FDOS has 
the following convenience features: 
* Character delete; CTRL/H (hold CTRE, key depressed, 
then strike H) deletes the previous character and 
echoes it back. ‘ea | 
* Carriage Return echo; if a LINE FEED is typed to ter- 
minate a line, a RETURN is automatically echoed if one 
was not typed prior to the LINE FEED. 


The Executive commands include the following general types. 
UNIT MANIPULATION COMMANDS 


The unit manipulation commands facilitate file positioning; 
these include Rewind, Skip, and Write End-of-File. If an 


illegal command is attempted on a unit (e.g., Writing an 


End-of-File on the photoreader), the command is ignored and 
"IMPROPER REQUEST (unit)" is printed on the console device. 


DATA UTILITY COMMANDS 


These commands facilitate the transfer of data to and from 
the various units supported by FDOS. The data utility 
commands include Assign, Reserve File, Copy, Verify, Dump, 
List, and Write. 


PROGRAM UTILITY COMMANDS 
These commands deal with the handling of data in the standard 
(absolute) binary format recognized by the System Loader. 


They include the Batch, GotT6, If Disk,..Save:Start Address," snds. 
Save, and Run commands. 
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VI.D. 


' VILE. 


DISK SYSTEM COMMANDS 


These commands are concerned with the Disk Directories, the 
Logical Unit Directories, and disk formats. They include For- 
mat Disk, Disk Directory, Logical Unit Directory, Rename, 

Delete, Queue, Temporary Queue, 'Restore, .and.Zero System commands. 
These disk system commands have no meaning for other peripherals 
Supported by FDOS. 


DESCRIPTION OF FDOS COMMANDS 


The following pages give a description of each of the FDOS 
commands. 


VI - 3 


VI.E.1L ADD TO LOGICAL UNIT DIRECTORY 


Purpose: Add files to the end of a logical unit directory. 


Format: AQ DUNT, NAME1],NAME2,... 
DUNT,NAME]L,etc., are as for QU. 


CARTE EAGAN 


Comments: Same as QU command, except that names are appended to the 
end of the current LUD. 
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VI.E.2 ASSIGN 


Purpose: Assign a physical unit to a functional unit. a 


Format: AS FUNIT,PUNIT,LCTR,PGCHR 
where: FUNIT = a functional or physical unit 
PUNIT = a physical unit 
LCTR index to the system's table of line counters 
PGCHR = N None F Formfeed | 
L Linefeed X Special character set during Sys-—Gen. 


II 


Comments: FUNIT is set to point to PUNIT. 


If PUNIT, LCTR and PGCHR are not specified, they are not changed. 
If "AS FUNIT,?" is typed, the assignment of the unit is listed. 
LCTR and PGCHR may be replaced with a "B" to specify that the 
unit is a binary unit (not capable of page formatting). 


VE =o 


VI.E.3 BATCH 


Purpose: Enter Batch mode 


Format: BA NAME 
NAME = name of file containing the Batch commands. 


Comments: A "batch" flag is set in the loader area (X7536B). Sub- 
sequently, all command lines are input from BC, rather than CK as in 
normal Executive operations. A return to the normal "on-line" opera- 
tion of the Executive occurs when an EOF is detected on BC, when a 
BX command is received from BC, or if an I/O error is detected. 


During Batch operation, Executive console messages (such as "EOF" 
reports during a copy) and echoing of Batch commands use BM for output, 
rather than CL as in normal operation. 


If NAME is not specified, the next file on BC is used. NAME can only 
be used if BC is a disk logical unit. 
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VI.E.4 BATCH EXIT 


Purpose: Return from Batch mode to the on-line (interactive) mode 
of Executive command input. 


Format: BX NAME 
NAME = File name to be used for next BA command. 


Persea) 


Sra seeped) Pi RRO 


Comments: A TQ of NAME to BC is done. A subsequent QU,RE, etc. of 
BC will override this TQ. If NAME is not specified, no action is taken 
with respect to BC. 
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VI.E.S COMMENTS 


Purpose: Allow comments to appear on Batch or on-line message units. 


Format: ** Text 


Comments: All characters after ** are ignored, up to the next .Linefeed. 


3 eA 
A . + in ot 


N.B.: A space must follow the **, 
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VI.E.6 COPY 


Purpose: To duplicate one or more files 


Format: CO SRCE,DEST,#,MODE 


Where SRCE = a physical or fanetional. unit 
DEST = a physical or functional unit 
number of files to copy 
A(ASCII), BA(absolute binaey: or B(relocatable . 
binary) 


tf 
MODE 


I 


q 


Comments: The remainder of the current file and the #-1 subsequent files 


of SRCE are copied onto DEST, each followed by a file mark. 


If @ is specified for #, 1 is used, but no file mark‘is written onto 
DEST. This feature, in conjunction with the Save command, is very 
useful in "patching" absolute binary programs. For example, suppose 
it were desired to change the contents of location 191B (the SIO 
Input pointer) whenever the Assembler (ASMB) is run. Then the 
following procedure could be used: 


1. Load the system (by starting at X7544B). Halt the 
| computer and change 181B to the desired value. Re- 
start at the Executive restart address ((X-1)4999B). 


2. Type QU D4,ASMB;QU D3,ASMB 
CO D4,D3,%,BA;SA D3,191B;WE D3 
RE D4;RE D3;:VE Pree eg eeice Daravane 


3. If the response on the console device to the last line 
above is. 


EOF D4 
GCG408 PCPG1G1 (new contents) (checksum__) 
EOF D3 


then the operation has been performed arcane 


Although this example would accomplish the desired re-assignment of the 
input device (DI), a more convenient way would be. via the Assign command. 


If SRCE is not specified, DI is used. 
If DEST is not specified, DP is used. 
If # is not specified, one is used. 


If MODE is not specified, ASCII is used. 
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VI.E.7° DISK DIRECTORY 


Purpose: To produce a list on a Specified unit the names of programs 
residing on the disk in the specified drive. 


DI DISK,DEST 
Where DISK = D,E,F, or G (floppy disk drive) 
DEST = a physical or functional unit 


Comments: Each disk has a disk directory recorded in sector 1 of track 0. 
This is different from the logical unit directories in that: 


(1) It contains only names of files actually recorded on 
the disk. : 


(2) It contains the starting sector address of each file. 


(3) It contains the starting sector address of the chain of | 
free disk blocks. . | 


(4) The order of files listed in it is of no significance. 
(See comments under LD command) 


If DEST is not specified, CL is used. 
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VI.E.8 DISK DIRECTORY WITH ADDRESSES 


“4 
‘ 


To produce a list ona specified unit the names of programs 
and their initial sector address. 


Purpose: 


Format: DA DISK,DEST 
Where DISK = D,E,F, or G (floppy disk drive) 
DEST = a physical or functional unit 


to the Disk Directory command (DI); 
the initial sector address 


of that program is printed. In addition, the symbol ".FREE." is 
printed, followed by the address of the first available (but not 


necessarily lowest numerical) sector of the free storage list. 


Comments: This command is similar 
in addition to the name of the program, 


If DEST is. not specified, CL is used. 
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VI.E.9 DELETE 


Purpose: To remove a file from the specified disk and free the sectors 
comprising it for reuse. 


Format: DL DISK,NAME 
Where DISK = 


D,E,F,or G (floppy disk :drive) 
NAME = name of file to be deleted 


comments: The file name is removed from the directory, and the chain of 
sectors comprising it are added to the beginning of the free storage 
list, i.e., the disk directory's free storage pointer is set to the first 
sector of the deleted file, and the last sector of the deleted file, 
which previously contained an end-of-file indication, is set to point 

to what was previously the first sector of the free storage list. 


If the file deleted is one of the Fixed Address files (SYS, SYS1, 
SYS2,SYS3 or SYSM) then the first sector (14B, 15B, 16B, 17B or 13B) 


is not added to the free storage list, but the remaining sectors of that 
file are added to the free storage list. 
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‘VI.E.1LO DUMP DISK 


Purpose: Produce a listing on a specified unit of the contents of a 
specified range of disk sectors. 


Format: DD DEST,DISK,LO,HI .-. 
Where DISK is a floppy disk drive 
DEST is a physical or functional unit 
LO and HI are the first and last (octal) disk 
addresses of the block of sectors to be dumped. 


Comments: The dump is printed in the following format: 


(sector address) 


Gg: word word e283 word (8 words per line) 
1g: word word 2s word 
172: word word im ee ge word 
(sector address) 
@: word word ns word 


If DEST is not specified, CL is used. 
If LO is not specified, 2 is used. 

If HI is not specified, LO is used. 
DISK must be specified. 
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VI.E.11 DUMP MEMORY 


Purpose: 


Format: 


Produce a listing on a specified unit of the contents of a 
specified range of memory locations. 


DM DEST,LO,HI 

Where DEST is a physical or functional unit 
LO and HI are the first and last (octal) addresses 
of the block of memory to be dumped. 


Cae NE 


Comments: The dump is printed in the following format: 


address: word word iecs word (8 words per line) 
address: word word note word 


If DEST is not specified, CL is used. 
If LO is not specified, 2 is used. 
If HI is not specified, LO is used. 
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VI.E.12 DUMP RECORDS 


Purpose: To provide a listing of specified records of a (possibly). 
| binary file. 


Format: | DU SRCE,DEST,LO,HI,MODE 


Where SRCE = a physical or functional unit 
DEST = a physical or functional unit 
LO = First record to be dumped (counting the next 
record as #1) 
= Last record to be dumped 
= A(ASCII), BA(absolute binary), or B(relocatable 


Comments: 


If SRCE is not specified, DI is used. 

If DEST is not specified, Cl is used. 

If LO is not specified, 1 is used. 

If HI is not specified, dumping proceeds’ until an end-of- 
file on SRCE. . 

If MODE is not specified, A is assumed. 


The process of dumping proceeds as follows. Each specified record is 
read from SRCE in the MODE specified. The characters of the record are 
then packed two per word, first the high order half, then the low order 
half. A listing of these words is then printed. In the listing, each 
word appears as six (6) octal digits, and these are printed eight (8) 
per line, using as many lines as necessary. Thus, for example, if the 
second record of the third file of logical unit D2 contains the ASCII 
character string ABCDEFGHIJKLM, then the first line of the output from 
the command 

RE D2;SK D2,2;DU D2,,2,5 » 
will be 

PG4G592 G41594 G42596 943519 944512 945514 46499 


Note that an assumed zero character fills the right half of the last . 
word. 


In most applications, CL or LP would be used for DEST. 
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VI.E.13 FORMAT DISK 


Purpose: 


Format: 


Comments: 


To prepare a virgin disk for use with FDOS 


FD DISK 


Where DISK = D,E,F, or G (floppy disk drive) 


(1) 


(2) 


(3) 
(4) 
(5) 


(6) 


The sectors of the disk, aside from those of track zero, 

are chained together into a free storage list. They are 

not chained in simple ascending numerical’ order. of: address... 
For each track, the chain starts at sector zero, proceeds 
through the even sectors (%,2,4,6,1%,12,14,16), then through 
the odd sectors (1,3,5,7,11,13,15,17). 


An initial disk directory is written into sector 1 of 
track zero. This contains 29 (a pointer to the first 


block of the free storage list) in its first location and 


the five Fixed Address files (SYS@, SYS1, SYS2, SYS3,and 
SYSM) and addresses (14B, 15B, 16B, 17B, and 13B)as entries. 


Empty logical unit directories are written into sectors 
4,5,6;. and :7 of track zero. 


The Fixed Address files are generated as empty (EOF) and 
written out. 


The unconfigured Bootloader is written in sector three of 
track zero. 


The configured syetai Loader is written in sector zero of 
track zero. 
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VI.E.14 GO TO 


Purpose: To allow the user to transfer from the Executive to a 
specified memory location. 


Format: GO WN 


N is the octal address to which to transfer. 


Comments: This command is useful in transferring to a core- -resident 
program (such as the Debugger). 
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VI.E.15 IF DISK 
Purpose: Determine whether or not the specified unit is a disk 
logical unit. 


Format: ID UNIT . 
Where UNIT = a physical or functional unit 


EO ee ae a cE A EIS 


Comments: If UNIT is a disk logical unit, the next command in the 


command line is executed. iE not, the remainder of the command line 
is ignored. 
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VI.E.16 List 


Purpose: To provide a listing of specified records of an ASCII file. 


Format: LI SRCE, DEST, LO, HI. : : 
Where SRCE = a ‘physical or functional unit 


DEST = a physical or functional unit 

LO = First record to be listed (counting the next 
record as number 1). 

HI Last record to be listed. 


Comments: 


If SRCE is not specified, DI is used. 

T£.DEST is not specified, CL is used,. 

Tf. LO is not specified, 1 is used. 

Tf HI is not specified, listing continues until an End-of- 


File on SRCE. 


In most applications, CL or LP would be used for DEST, If a cassette 

deck or disk logical unit is specified, the effect is to copy the speci- 
fied records from SRCE to DEST, a function which cannot. otherwise be 
performed. To skip records, BK could be used for DEST. 


If one wished, for example, to determine the contents of the second file 
of the cassette in deck 2 by listing the first five lines, this could be 


accomplished by using the command 


RE 2;SK 2;LI 2,5,5 — 
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VI.E.17 LIST ALL UNITS 


Purpose: To print the contents of the Functional Device Table (FDT). 


Format: LA UNIT | 
Where UNIT = unit on which to produce the listing. 


Comments: The FDT is printed on UNIT in the same format as during the 
system generation. _ 


If UNIT is not specified, CL is used. 
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VI.E.18 LOGICAL UNIT DIRECTORY 


Purpose: To list the file names comprising the specified logical unit. 


Format: LD DUNT . 
Where DUNT = D1,D2,D3,D4 (logical units of disk drive D) 
EL,E2,E3,E4 (logical units of disk drive RB) 
F1l,F2,F3,F4 (logical units of disk drive F)° 
G1,G2,G3,G4 (logical units of disk drive G) 


Comments: A logical unit consists of a list of names (up to five alpha- 
meric characters, first alphabetic) in a fixed order. These names 
correspond: to files potentially, but not necessarily actually, on the 
corresponding disk. These lists, corresponding to the four logical 
units of the given disk, are kept in four sectors of track zero of that 
disk: 


octal) Logical Unit 


Sector 
. 4 


SO Usd 


1 
2 
ce 


These directories can be set up by the user through use of QUEUE command. 
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VI.E.19 QUEUE 


Sf STD yeaa Be 


Purpose: To set up a directory of the specified logical unit. 


Format: QU DUNT,NAMEL,NAME2,. .. 
| Where DUNT = D1,D2,D3,D4 (logical units of disk drive D) 
E1,E2,E3,E4 (logical units of disk drive E) 
FL,F2,F3,F4 (logical units of disk drive F) 
GL,G2,G3,G4 (logical units of disk drive G) 
Where NAME], NAME2,. . . are file names. 


Comments: (See comments under the Logical Unit directory command - LD.) 
The LUD for DUNT is set to. consist of NAMEL,NAME2,..., and UNIT is 
rewound, so that it is positioned at NAME]. 


QU BUNT deletes all names from the LUD, but does not delete the files 
from the disk (or Disk Directory). 

When the command QU DUNT,NAME1 is given, NAME] gets added to the LUD, 
but NAMEL does not get added to the Disk Directory until it is used. 
for an output function. 
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VI.E.20 RESERVE FILE 


Purpose: Reserve a file of a specified length. 


Format: RF DISK,NAME,#. 
Where DISK = D,E,F,G 
NAME File name 
i# = Number of sectors 


Comments: A file of the specified length and with the specified NAME is 
created on the specified disk. 


-If a file called NAME already exists on the given disk, its length is 
checked, and additional sectors are added to it if it is shorter than 
the number of sectors specified in the command. 


The purpose of this command is to create a file in advance of operating 
'with it. This reduces the amount of head motion (therefore, time) re- 

quired in actually writing a file, since the free storage list (in 

track zero) does not have to be accessed each time another sector is 
required. 


If, during subsequent output to this file, all reserved sectors are 
“not used when the file is closed (by writing an EOF) the unused 
sectors are returned to the free storage list. If more sectors 

than were reServed are required during the actual output to the 

file, additional sectors are taken from the free storage list. Thus, 
one needs only to approximate the number of sectors required for 

the file. 
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VI.E.21 RESTORE 


Purpose: Restore the original SIO configuration. 


Format: 


Comments: A “warm start" entry is made to the System Loader, and the 
SIO driver area is restored from disk, wiping out the effect of any 
Assign commands. i 
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VI.E.22-- RENAME 


Purpose: - To change the name of a specified file on a specified drive. 


Format: RN DISK,OLDN,NEWN . . . 
Where DISK = D,E,F,G (floppy disk drive) 
OLDN is the name of the file before renaming; 
NEWN is the name of the file after renaming. 


comments: The name is changed in the Disk Directory. Also, the name 


word (which contains the name code computed from the file name) is 
changed in each block of the file. If the file in question is Queued 
ona disk logical unit, the name in the LUD is not changed. 
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VI.E.23 REWIND 


Purpose: To position a unit at the start of the first file. 


Format: RE UNIT 
Where UNIT = a physical or functional unit 


CY AAAI ERATE LY ATS AM SR ESLER PE ITO ST A AA LENE ETS SEE A SECIS MOLI Ne Re ae 


Comments: If UNIT is a cassette deck, a rewind of the specified deck 
is initiated, and control returns to the user without waiting for the 
rewind to be completed. 


If UNIT is a disk logical unit, the effect of the command is modification 
of the in-core logical unit parameter table (LUPT)" to indicate that the 


unit is positioned at the start of file 1 of that unit. 


Tf UNIT is not specified, DI is assumed. 
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VI.E.24 RUN 


waa cn 


Purpose: To load a specified file from drive D and transfer control. 


Format: RU NAME,S.A:,parameters’ ~~ 


Where NAME 


= name of file. 
S.A. =’(octal) start address if standard not desired. 
parameters — format determined by program being called. 


chee Sat Sere EET 


Comments: Same as RD, except drive D is assumed. 
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VI.E.25 RUN FROM SPECIFIED DISK 


Jn 


Purpose: To load a named file from a specified disk and transfer 
control. . 


Format: RD DISK,NAME,S.A., parameters 


Where DISK = D,E,F or G (floppy disk drive) 
NAME = name of the file 
S.A. = address to which to transfer control if . 
standard not desired. 
parameters - format determined by program being run. 


CASAS POL NS SEAN TARUFISUEIOL ISS OPS Beate 


Comments: When this command is given, the Disk Directory is read from 
DISK. This directory contains the names and starting sector addresses 
of the files on that disk. If the name is not found, a message to 

that effect is printed. Otherwise, the parameters are used to set up 
PARAM through PARAM+7 of the Communication Region, S.A. is used to set : 
STRTA in the Communication Region,.and a transfer tis made to the System 
Loader ELOAD entry with the appropriate drive and sector address. 
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VI.E.26 SAVE 


Purpose: To write an absolute binary format image of the area of 
memory from FWA to LWA inclusively, capable of being loaded 
into memory locations ADDR thru ADDR+(LWA-FWA) at a later 
time. 


Format: SA UNIT, FWA, LWA, ADDR 

Where UNIT = 1,2,3 (cassette decks) 
D1,D2,D3,D4 (logical units of disk drive D) 
E1,E2,E3,E4 (logical units of disk drive E) 
F1,F2,F3,F4 (logical units of disk drive F) 
G1,G2,G3,G4 (logical units of disk drive G) 


Comments: The portion of.memory lying between the two addresses FWA 
and LWA (inclusive) is written.on the specified unit as a series of 
128-word absolute binary format records. That is, 


G764 9B . _ (#data words, i.e., 125, in high’ 
order) 
FWA + 125 (n-1) (starting address in memory of 


data of the n-th record) 


contents of first location 
contents of second location 


contents of 125-th location 


checksum (sum of the address and the data 
words ) 


If the number of words written is not a multiple of 125, the n-th 
record is shorter, but of the same format as above. 


If UNIT is not specified, DP is used. 


If FWA is not specified, then 2B is used. 
If LWA is not specified, then FWA (one word) is used. 
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If ADDR is not specified, FWA is used; ADDR specifies the intended 
load address. Thus, the words written from memory locations FWA thru 
LWA will be loaded back into ADDR thru ADDR+(LWA-FWA) . 


N.B. No file mark is written after the data records, so multiple 
saves can be used to build a file. When the desired portions of memory 
have been saved, a file mark MUST be written (to close the file) using 


the WE command. ; 


(See example under COPY command.) 
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VI.E.27 ° SKIP 
Purpose: To position a unit at the start.of the N-th following file. 
=e ; ee ot . 


‘Format: SK UNIT, | 
Where UNIT = a physical or functional unit. 


tf number of files to skip. 


Comments: If UNIT is a cassette deck, successive "search" commands are 
issued, and control returns to the user when the drive becomes "ready" 


If UNIT is a disk logical unit, the in-core logical unit parameter 
table (LUPT) is modified to indicate position at the start of the 
#-th file following the current one. 


. Lf UNIT is not specified, DI is assumed. 
Tf # is not specified, 1 is assumed. 
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VI.E.28 ‘SAVE START ADDRESS 


Purpose: To write an absolute binary format record of locations 
2B-and3B as the standard start procedure, using the specified 
address as the start address (location 3). 


Format: SS UNIT,ADDR ae | 
: Where UNIT = a physical or functional unit. 
ADDR (octal) start address desired. 


II 


Comments: An absolute binary format record (to be loaded into locations 
2B and 3B) is written on the specified unit, without distrubing locations 
2B or 3B. 


This is usually used in conjunction with, and usually prior to, the 
Save command when building a file. 


N.B. No file mark is written after this record. 


If UNIT is not specified, the DP is assumed. .= 2. 
ADDR must be specified. 
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VI.E.29 TEMPORARY QUEUE 


Purpose: To temporarily attach the specified file to the specified 
logical unit. 


Format: TQ UNIT,NAME 


UNIT = disk logical unit 
NAME = name of file to be attached. 


Comments: The in-core LUPT is set up to the start of the file called 
NAME. The in-core file number is backed up by one, so that when EOF 
is detected in NAME, the LUPT is set up as it was before the TQ. 


The LUD on disk is not modified, so TQ can be used with a write- 
protected disk. : 
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VI.E.30 VERIFY 


Purpose: To compare one or more files. 


Format: VE SRCE,DEST, #,MODE: 
Where SRCE = a physical or functional unit 


DEST = a physical or functional unit 

th number of files to compare 

MODE = A(ASCII), BA(absolute binary), B(relocatable 
binary) 


Comments: The remainder of the current file and the #-1 subsequent 
files of SRCE are compared with the corresponding files of DEST. 

If @ is specified for #, 1 is used, but the process terminates with 
the detection of a file mark on SRCE. (Normally, a final read of 
DEST would then be made and an error reported if no file mark were 
detected there.) . 


If SRCE is not specified,DI is assumed. .- . od” evs 
Tf DEST is not specified;DP is assumed. adh << >, ee 
Tf # is not specified, 1 is assumed. 
If MODE is not specified, A is assumed. 


(See the example under COPY.) 
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VI.E.31 WRITE 


Purpose: To allow ASCII data to be output directly into a file on 
a unit. 


Format: WR DEST, SRCE 


(line of text) 
(line of text) 


(CTRL/D) 
Where DEST = a cassette deck, a disk lhogical unit, T,L, or P 


Comments: As each line is input from SRCE (normally a keyboard), it is 
output to DEST. When the CTRL/D (followed immediately by Carriage 
Return then Line Feed) is input, a file mark is written on DEST and 
control returns to the user. 


For example, if the user wanted to put a file of Batch commands at the 
start of logical unit El, the following sequence could be used: 


RE EL;WR El | : 

RE 2;SK E1;CO 2,E1L;RE 23;RE"E1;SK EL;VE 2,E1.°7 =.. Pei 
RU. ASMB,,,2;BX 

(CTRL D) 


If El is subsequently used as the batch input unit and DI, the above 
sequence will cause a source program to be copied into the second 
file of El and assembled, after which the system will leave the Batch 
mode. 


If DEST is not specified, DP is used. 
If SRCE is not specified, CK is used. 
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VI.E.32 WRITE END-OF-FILE MARK 


Purpose: To terminate the current output file on a cassette or disk 
logical unit. 


Format: WE UNIT _ tet ites pate chad . 
Where UNIT = a physical or functional unit. 


Comments: If UNIT is a cassette deck a 3/4" gap of blank tape is 
written, followed by a record consisting of the single character 4B 


(control D, or EOT). 


If UNIT is a disk logical unit, an end-of-file indication is written 

in the current block of the current file, any remaining blocks of the 
-file are released, and the in-core logical unit parameter table (LUPT) 
is modified to indicate that the unit is positioned at the start of the 


next file. 


N.B. The integrity of the data written into a file is not assured unless 
the file is properly terminated. 


If UNIT is not specified, DP.is assumed. 


(See comments under the DELETE command 
describing how the, remaining blocks of 
the file are released) 
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AVI.E.33 ZERO SYSTEM 


Purpose: To clear all SIO disk buffers of any holdover sectors 
before changing disk cartridges in a drive. 


Format: 2S 


4 
hye OP AP IDR SPE EE PE TNE ANSTO ELOTEEE OPEN TTD MEEK F PO OS RET 


Comments: The hueristics used in the SIO Driver to minimize disk 
sector reading and writing cause sectors to reside in core. Ifa 
disk is changed in a drive, and a sector is accessed that resides in 
core from the previous disk, SIO will use the old sector rather than 
read the new one (usually resulting in a Format Error). 

The ZS is used to clear out all SIO buffers so that there is no hold- 
over, and all new sectors are read. 
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VI.F 


FDOS EXECUTIVE MESSAGES 


1. The FDOS Executive prints messages when certain conditions 
arise. Those which apply generally to the various commands are 


as follows: 


ILC 

The last command processed by the Executive is de- 
fective in some way, most probably because an illegal 
character appeared or because one of the parameters 
does not €all within the expected set of values. 

The Executive discards the remainder of the command 
line and waits for the operator to type another. 


NOT READY (unit) 

When the Executive attempts to perform an operation 
on a unit, the driver, DIO, checks to see if the unit 
is ready before issuing the command. If the unit is 
not ready, the driver returns the "not ready" in- 
dication, and the Executive prints the "NOT READY 
(unit)" message. ; 


WRITE LOCK (unit) 

This message is printed if DIO returns the "write 
locked" indication in response to an attempt to 
write on a write-protected disk or cassette deck. 


EOF (unit) 

This message is printed if DIO returns the "end of 
file on read" indication.in response to an attempt 
to read data from a unit. This is usually not an 
error condition during executive operations. It 

is printed mainly to help the operator keep track of 
the progress of multifile operations. 


END OF TAPE (unit) 

This message is printed if DIO returns the "end of 
tape" indication on an attempted read/write operation. 
This results in the termination of the command and the 
loss of the remainder of the command line. The 
Executive waits for the operator to type another 
command. 
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WRITE ERROR (unit) | 
This message is printed if DIO returns the "rate 
error" indication in an attempt to write on a disk. 


READ ERROR (unit) 

This message is printed if DIO returns a "rate error" 
or "CRC" (parity) error" indication in an attempt to 

read from a disk, or if DIO returns a "parity error" 

indication in an attempt to read from cassette. 


FORMAT ERROR (unit) 

This message is printed if, while accessing a named 
disk file, the name code in the first word of each 
sector does not.:verify with the file name :(chaining 
error).. | 


UNKNOWN DEVICE (unit) 
No such peripheral device has been defined (at 
sys-gen time) in the system. 


IMPROPER REQUEST (unit) 
This message is printed if unit specified cannot 
perform the function requested. 


TYPE 'GO' WHEN READY 


This message is printed after "NOT READY (unit)" and 
"WRITE LOCK (unit)" messages and at other times. 

When the operator types "GO", the Executive retries 
the operation or goes on to its next task. If the 
operator types "NO", the Executive aborts the command. 


2. The "fixed address files" reserved for the basic FDOS soft- 
ware system are named SYS@, SYS1, SYS2, SYS3, and SYSM. To 
protect these, and to allow for other protected files, any file 
whose name begins with the letters "SY" is considered a "system" 
file. When such names are input to the Executive the following 
is typed for each reference: 


SYxx? ? 
ARE YOU QUITE SURE? 
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Only the response of "JA" will cause the Executive to continue 
processing the requested command. Any other response will cause 
the "ILC" message, and that command (plus the remainder of the 
command line) will be aborted. 


To avoid inconvenience when intentionally doing work with these 
files, the Executive has two additional commands: 


SE System name work Enable 
SD System name work Disable 


In the Enabled mode (SE), the above discussed verification 
message is not typed, nor is a response expected. The "SD" 
“command returns the Executive to the normal mode (ie., the 
verification is performed on each "SY" reference). In addition, 
the execution of a.RE, WE, FD, DL, RN, AQ, or QU command causes 
the Enable mode to be exited at the end of the current command 
line; an illegal command or system reload causes an immediate 
exit from the Enabled mode. 


VI.G. PAPER TAPE EQUIPMENT CONSIDERATIONS 


Since paper tape equipment does not have file-manipulation 
capabilities, special considerations apply when it is per Sete 
ina command. 


1. Ten nulls (feed frames) define an End-of-File on input from 
paper tape. Thus, when mounting a paper tape on the low-speed 
(TTY) reader, valid data for the desired file must be placed 
within ten frames of the read station; if this is not done, an 
"HOF LS TAPE" message will occur upon subsequent input from the 
low-speed reader. 


2. On input from the high-speed reader, nulls are ignored until 
a valid record (of the specified type) is encountered; thus the 
tape can be mounted at any point on the leader. 


3. I£ an operation with paper tape is aborted before completion 
(such as a compare error when verifying from paper tape to some 
other device) the driver retains the fact that the paper tape 

is in the middle of the file. Thus, if the operator positions 

the paper tape back to the beginning, the driver must be informed 
of this manual intervention. This can be accomplished by rewinding 
the appropriate reader (RE HT or RE LT). A HLT 6@B will occur, 
thus reminding the operator to reposition the paper tape; when 
complete, press RUN. 
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4. If an ASR33 punch is used, two halts apply: 


HLT 56B - printing complete; turn on low-speed 
punch and press RUN. ; 


HLT 55B - punching complete; turn off low-speed © 
punch and press RUN. 
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VII. 


VITA. 


TILT.A.1. 


SYSTEM PROCESSORS 


The FDOS system processors provided are (primarily) modified 
versions of standard Hewlett-Packard programs. The modifi- 
cations allow the various processors to be called by (and 
return to) the FDOS Executive, thus acheiving automatic, 
"hands-off" operation. The modifications also allow the | 
processors to position the I/O media between passes, providing 
the media is disk or cassette. If the I/O unit defined is 
paper tape, certain halts will occur during processor operation 
to allow manual intervention; upon completion, RUN is depressed 
to continue the processor. These halts are: 


HLT 6B - end of paper tape; rewind tape, mount in 
reader, and press RUN. 

HLT 57B —- end of source section; mount next paper 
tape and press RUN. 

HLT 56B - (ASR 33 only) printing complete; turn on 
low-speed punch and press RUN. 

HLT 55B - (ASR 33 only) punching complete; turn off 


low-speed punch and press RUN. 
EDITOR 


This program is a modified version of the Hewlett-Packard 
Editor 20100B. Its operation is very similar to that described 
in the manual HP 02116-9016, with the primary difference that 
the "/D" device selection (instead of "/M") refers to -input and 
output via FDOS functional: units. > 

The following brief summary of the editors's operation can be 
supplemented by reference to the above-mentioned H-P manual: 


Entry of the edit file. 
The program asks for the edit file device. 
The following answers are accepted: 


/T Edit file is to be typed 
/A EQit file is to be read from AK... 2. 77 7sart: 


{3 
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The edit file consists of combinations of the following 
commands: 


/F,n Open the n-th file. That is, copy files from the : 
Input unit to the Output unit until the beginning of the 
n-th file is reached. /F,1 is assumed if any edit command - 
other then /L or /l,,n appears as the first line of the 
edit file. 


/I,n Insert one or more lines after the n-th line of the 
currently opened file. The lines inserted are all those 
lines of the edit file lying between this control state- 
ment and the next control statement. 


/D,n,m Delete line n through m of the currently opened 
file. /D,n is used to delete the n-th line. 


/R:n,m Replace lines n through m of the currently opened 
file. /R,n is used to replace the n-th line. /R,n,m has 
the same effect as /I,n-l1 followed by /D,n;m. : 


/CL Ny I Insert text after the m-th character of the n-th © 
line of the currently opened file. The text to be inserted 
appears on the line following this control statement. 


/CD,n,m,k Delete characters m through k of the n-th line 
of the currently opened file. /cD,n,m deletes the m-th 
character. 

/CR,n,m,k Replace characters m through k of the n-th 

line of the currently opened file. This is equivalent 

to /CI,n,m-1 followed by /CD,n,m,k. 


/L,n List’the n-th file. /L is equivalent to /i,1. 
The only other command allowed in an edit file con- 
taining this command is /E. 


/s Delete the last previous line of the edit file. 


/E Close the currently opened file (if any), i.e., 

copy the remainder of it to the Output unit and*termin- 
ate the edit. Note that if a /L,n command appears as the 
only other line in the edit file, no file is considered 
to be open, so no copying to the Output unit occurs... 
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If an end-of-~file is encountered before a /E command is found, 
the editor says "END OF TAPE". 


To read the remainder of the edit file from another tape, 


position the new tape in the Input unit and type "GO". 


To terminate the edit file, type /C followed by /E. 
Specification of the symbolic file device. 


The program asks for the symbolic file source device and the 
symbolic file destination device. The possible replies are: 


/D Use DI or DP. 
/A Use AI or AP. 


If an end-of-file or end of punched tape is encountered during 
symbolic file input, the editor says "END OF TAPE". If further 
symbolic input is not required, the edit process is completed. 
and a return to the Executive is made via a transfer to the 
System Loader (X754@B). If further symbolic input is required 
(e.g., in the /F,n command), the Editor proceeds to input the 
next file from the input device. If paper tape is being used, 
the operator must mount the next tape in the reader. 


ASSEMBLER 


This program is a modified version of the Hewlett-Packard 
Assembler 24031B. It is supplied in three versions: Floating 
Point (ASMBF), EAU (ASMBE), and Non-EAU (ASMBN). It uses DI 
for source input, DP for binary output, and offers a choice 

of list output to HL or PL. Listing uses PL if the P option 


is specified during the call of the assembler (e.g., Ri. AShss 
RU ASMBF,,,,P). 


The assembler recognizes I/O options specified by the contents 
of certain locations in the parameter area of the Communication 
Region. If the assembler is loaded using the Executive 
program, these can be set by a call of the form: 


RU ASMB,,P1,P2,P3 


NOTE: The calls for:all three assemblers (ASMBF, ASMBE, and 
ASMBN) are the same; the name of the version desired would be 
used instead of ASMB. It may be desirable to delete the unused 
assemblers from the working disk, and rename the desired one to 
ASMB (see Software Installation section). 
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If the Executive is not used, Pl through P3 must be set into 
cells PARAM #1 (X7525B) through PARAM +3 .(X7527B). Numbers 
must be entered as their actual values, while letters are 
represented by their 7-bit ASCII codes. Missing parameters 
are set to zero. The parameters are interpreted as follows: 


P1:K = accept control statement from PK; 

I = ignore first statement of the source program 
(assumed to be the control statement) and 
accept control statement from PK; 

If Pl is any character other than I or K, the 
control statement is expected to be the first 
statement of the source program. 


P2: The number, counting from one, of the file on 
DI to be assembled; if not specified, defaults 
to assembling the first file. 


P3:P = Write listing and symbol table (if requested 
in control statement) to PL; otherwise use HL. 
NOTE: If HL used and it is a disk logical unit, 
a file must be queued on HL even though no :% 
listing or symbol table is requested; this is 
. because HL must be capable of receiving any 
error messages, etc., that are generated. 


The assembly control statement consists of "ASMB" followed by 
one or more of the following: 


,A Absolute assembly 

»R Relocatable assembly 

,B Produce a binary output 

»,l Produce a list output , 


,T Write the symbol table at the end of the list output 
(if any). 


,C Follow the assembly by a call to the Cross-Reference 
Table Generator. 


NOTE: If the listing. is directed to HL, the normal error summary - 


is also printed on CL at the end of each pass for the 
operator's convenience. 
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Use of the Assembly Control Statement C option causes the code 
for CROS to be set in LERR (X7537B) before the transfer to the | 
System Loader (X7549B) which occurs at the end of the assembly. 
The program first clears PARAM+1] (X7525B) and then loads the 
Cross-Reference Table Generator. 


If the Assembler detects an End-of-Source Section condition 
(End-of-File on disk/cassette or End-of-Tape on paper tape 
prior to detecting an END statement), then the following 
applies: 


ds. LE DI is a paper tape device, a HLT 57B is executed; 
- -this allows the operator to mount the next paper tape 
of the source program. Press RUN to continue the assembly. 


2. If DI is cassette, the same HLT 57B considerations apply. 
However, upon detection of the END statement (interpass 
rewind) the Assembler will initiate a rewind, wait for 
rewind completion, then issue a HLT 57B,C (103057B instead 
of 102057B); this informs the operator to turn the cassette 
over and position it to the begining of the source program. 


‘An Assembler Control Statement C option (call. for CROS) is “ 


, treated the same way (interpass rewind). 


3. If DI is a disk logical unit, no halts occur; the Assembler 
assumes that the various Source Section files have been 
- Queued on DI prior to calling the Assembler. 


The control statement errors "CS" and "R?" are printed on PL (in 
addition to HL if it was chosen in the assembler call) and a new 
control statement is accepted from PK. If the original statement 
was from the source program (DI), then the "I" option of the 
assembly call is forced (see Pl parameter description). 


The Floating Point instructions FIX and FLT can be used even 
though the Floating Point hardware is not available. The Non-EAU 
and EAU Assemblers generate calls to library functions IFIX and 
FLOAT, respectively, and automatically provide for the external 
statement linkages (as they do for FDV, FMP, FAD, and FSB). 
Except for speed, the differences between the Non-EAU/EAU 
Assemblers and the Floating Point Assembler are transparent to 
the user. 


In order to use the EAU shift-rotate instructions (ASR, ASL, LSL, 
RRR, RRL, and SWP) the EAU hardware must be available; the Non-EAU 
Assembler does not recognize these instructions. 
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The RAM instruction (not mentioned in most HP documentation), 
which is used for executing. user's microprograms, is implemented 
in all versions of FDOS assemblers. 


VII.C. CROSS-REFERENCE TABLE GENERATOR 


This program is a modified version of the Hewlett-Packard Cross- 
Reference Symbol Table Generator program 24109B. It uses DI 

for input of the source program and offers a choice of list 
output to HL or PL. Listing uses PL if the P option is specified 
during the call. 


The Cross-Reference Table Generator recognizes several options 
specified by the contents of certain cells in the parameter 
area of the communication region. If the program is loaded 
using the Executive program, these can be set by a call of the 
form: . 


RU CROS,,P1;,P2;,2P3 


If the Executive is not used, Pl through P3 must be set into 
cells PARAMf1 (X7525B) through PARAM+3 (X7527B). Numbers must 
be entered as their actual values, while letters are represented 
by their 7-bit ASCII codes. Missing parameters are set to zero. 
The parameters are interpreted as follows: | 


Pl:K = accept a range of characters from PK, and do a 
cross reference table of all symbols whose 
initial characters fall into the character 
range included between the two characters typed. 
Otherwise, do a table of all symbols. 


P2: The number, counting from 1, of the file on DI 
to be processed. 


P3:P = write output to PL. Otherwise, use HL. 


If the Cross-Reference Table Generator program is to be called 
automatically when the C Assembly Control Statement option is 
specified, it must be on the system disk (if the Executive is 
used) with the name CROS. In the case of an automatic call 
from the assembler, Pl is cleared, and P2 and P3 are as they 
were specified for the assembler. 
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VII.D. DEBUGGER 


tisdale 


The interactive debugger program (DEBUG) supplied by Dicom is 
used to interface with machine language, SIO-oriented, user 
routines as an aid in debugging. DEBUG provides for an active 
breakpoint within the user's routines. The accumulators (A and 
B registers) and memory can be examined and modified from the 
console device TTY (either the standard HP-interfaced tele- 
printer or "deck zero" Teletype/CRT) after a breakpoint has 
occured. 


When the breakpoint (that has been inserted in the user's program) | 
is encountered, DEBUG is entered via a jump through location 4B. 
Upon entering DEBUG via the breakpoint, the contents of the A, 

B, Overflow, and Extend Registers are saved; thus these registers 
can be restored by DEBUG when returning to the user's routine 

via the Proceed or Run Commands of DEBUG. When entering DEBUG 
via the breakpoint, the breakpoint address and the values of the 
A and B registers are printed on the console device; at this 
point DEBUG can be used to examine memory locations, dynamically 
"patch" the user's program, establish a new breakpoint, and 
re-enter the user's program. 


DEBUG commands are single keystrokes (usually letters) pre- 
ceeded by an argument when applicable. The argument defines 
a memory address. The commands recognized by DEBUG are 
described below. 


DEBUG COMMANDS 


N/ Print contents of location N. Location N is then 
open, so an octal number followed by RETURN or 
LINEFEED will cause that number to be stored into 
location N. If no number is typed before the 
RETURN or LINEFEED, location N is not modified. 


N; Print contents of location (N+offset). This 
location is now open, as above, 


/ Reopens location N. 

: Reopens location (Ntoffset). 

LINE Close current location (N or N+offset), changing the 
FEED contents if a number was typed before the LINEFEED, 


and open next by typing 
(N+1)/ XXXXXX 
or (N+1); XXXXxXxX 


VII-7 


RETURN 


4 


B/ 


1/ 


Same as LINEFEED, except that the next location is 
not opened. 


Same as LINEFEED, except that the previous location, 
rather than the next, is opened. 


Examine and open the A-register location. This 
location is set to the value of the A-register on 
each entry into DEBUG, and it is used to set the 
A-register before transferring control in response 
£0..P Or Re 


Same as %/, except for the B-register. 


Examine and open breakpoint. A value of zero 
indicates that there is no breakpoint. A non-zero 
breakpoint: causes a JSB 4B,I to be placed in the 
location specified just before the DEBUG transfers 
control in response'to P or R. (N.B. Location 4B 
is used as a pointer). A breakpoint can not be 
used on multiple-word instructions. 


Examine and open the E and O location. This location 
is set to the values of the Extend and Overflow 
registers on each entry into DEBUG, and it is used to 
set them before transferring control in response to 


Por R. The format of the word is: EH=bit 15; 


Examine and open the location specified in bits 
14-9 of the contents of the last location opened. 


Examine and open break pointer location. 


Relocate DEBUG by a multiple of 28@@B, so that it 
resides on the memory page containing location N. 


Examine memory referenced by last contents. 


Proceed from a breakpoint. When a breakpoint has 


been inserted into a program at’ location XXXxXX and 
the program reaches that location, the debugger 
prints. 

XXXXXB aaaaaa bbbbbb 


Where aaaaaa and bbbbbb are the contents of the A- 
and B- registers. The operator can now use DEBUG 
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commands to modify memory locations (including 
XXXXX), move the breakpoint, change the values of 
A,B,E and O, etc. If it is then desired to continue 
execution of the program, the P command is used. 


If the breakpoint has not. been moved, then P cannot 
be used if XXXXX contains a JSB to a subroutine 
which expects an argument in a location relative to 
the location of the JSB, or which has a return to 
any location other than one of the two locations 
following the JSB. 


NP Proceed from the breakpoint N times. 


NR Run from location N. A,B,E and O are set and. 
control transfers to location N. 


S Proceed from the breakpoint, but suppress break message. 


NS Proceed from the breakpoint N times, but suppress all 
7 but last break message. 


NT Trace - move breakpoint to location N and proceed 
from the breakpoint. 


x Examine and open the offset register. This is the. 
offset used in connection with the semicolon. 


IT.D.2. STARTING DEBUG 


When DEBUG is called via the Executive, it is loaded into locations 
G4290B through approximately @54@@B, and is automatically executed; 
it assumes that the console device is on channel 12B (since DEBUG 
is a "stand-alone" program that does not use the SIO driver package). 
If a different channel is desired, halt the computer, set bits 

5 through @ of the location 42%1B to the desired channel (with 
bit 15 = 1 if “deck zero" is used), and restart the computer at 
location @429@B. If it is desired to write this modified version 
of DEBUG to the disk, relocate DEBUG (use %2@@L), reload the 
Executive (use X7544R), remove the write protect tab from the 
system disk, and use the following command string to write 

DEBUG to disk: 


TQ D1,DEBUG;SA D1,20%B,149B;WE D1 
VII.E. FDOS FORTRAN COMPILER 


The FDOS FORTRAN package consists of modified versions of the 
Hewlett-Packard FORTRAN pass one and pass two programs (HP 20548A). 
Pass two is supplied in two versions; Floating Point/EAU (FOR2E) 

and Non-EAU(FOR2N). The package uses DI for source input, SC for 
intermediate-tape storage, DP for binary output, and offers a 
choice of list output (if requested) to HL or PL. 
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FORTRAN recognizes options specified by the contents of certain 
locations in the parameter area of the Communications Region. 
If FORTRAN is loaded using the Executive EOgE et these can 

be specified by a call of the form: | 


RU FORT, ,P1,P2,P3,P4 


If the Executive is not used, parameters Pl. through P4 must be 
set into cells PARAM+1 (X7525B) through PARAM+4 (X753@B). Num- 
bers must be entered as their actual values, while letters are 
represented by their 7-bit ASCII codes. Missing parameters 
are set to zero. The parameters are interpreted as follows: 


Pl:K = accept control statement from PK; 
I = ignore first statement of the source program 
(assumed to be the control statement) and 
accept control statement from PK; 


If Pl is any character other than I or K, 
the control statement is expected to be the 
first statement of the source program. 


P2: the number, counting from one, of the file 
on DI to be compiled; if not specified, 
defaults to compiling the first file. 


P3:P = write all listings and symbol table (if 
requested in control statement) to PL; 
otherwise use HL. 

NOTE: If HL used and it is a disk logical 
unit, a file must be queued on HL even though 
no listing or symbol table is requested; 

this is because HL must be capable of re- 
ceiving any error messages, etc., that are 
generated. . 


P4:E = use Floating Point/EAU version of pass two 
HORE: 


X = use FOR2X or FOR2F version of pass two; these names 
or F have been included in order to accomodate user- 
supplied (or future) versions of pass two. 


If P4 is any character other than E, F, or 


X, the Non-EAU version of pass two (FOR2N) 
will be used. 
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The compiler control statements consist of "FTN" followed by 
one or more of the following: 


,A Produce Assembly level listing (Pass two) 
,B Produce Relocatable Binary 
,L Produce source listing (Pass one) 


,rT Produce Assembly level symbol table only 
(Pass two).- 


The FDOS FORTRAN Compiler called is stored on disk in two files: 
pass one (FORT) and pass two. FORT performs an initial pass 
over the source program, converting the FORTRAN statements into 
an intermediate binary form. This intermediate binary file is 
written onto a scratch file (the first file on SC is used), 
which is read by pass two and translated into standard relo- 
catable binary format. 


To operate FORTRAN, the user must Queué the FORTRAN source 

program in DI, Queue a file for the relocatable binary as the 

next file on DP, Queue a file on SC for the intermediate-tape, and 
-Queve a.file::ion’ HL. (if required)... .IfiHL.is specified for: list © 
and HL is a disk logical unit, a file must be available (even 
though no listing is requested; see P3 description); if this 

is not done, the compiler will halt with an "“End-of-tape in 
write"(HLT 66B, see Section IV.C.1). 


A scratch file must be Queued as the first file on the scratch 
unit (SC). This scratch file can be left on the disk, where 

it will be used each time FORTRAN is run, or it may be deleted 
after FORTRAN is run. FORTRAN will run faster if the scratch 


file already exists on the disk, so it is wise to simply leave 
the temporary file on the disk. 


After the files have been Queued appropriately, the user types: 


RU FORT, ,P1,P2,P3,P4 
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When the program comes into memory it positions DI and ejects 
a page on the list unit (just a "thunk" on PL if the Form Feed 
option is in effect). Then it waits for the user to type the 
control statement if the Pl = K or I. The compilation is then 
performed, and the program returns to the FDOS Executive by 
transferring to the System Loader (X754@B). 


DISK UTILITY PACKAGE 


The FDOS Disk Utility Package (DUP) was designed primarily to 
duplicate disks. It is structured to copy and/or verify on a 
track .for track basis (instead of being sector oriénted as is 
the rest of FDOS). This approach results in a significant 
saving of time; it takes approximately forty-five seconds to 
reporduce (copy and verify) an entire 131K word disk using 
DUP, vs. two and one-half minutes using a sector for sector 
basis. : 


DUP is not part of the Executive, since DUP requires AK of 
memory (two tracks) for buffers. 


When DUP is called, command information is passed via the 
standard parameter scheme. If DUP is called using the 
Executive program, these can be specified by a call of the 
form: | 

RU DUP,,P1,P2,P3,P4,P5,P6 
If the Executive is not used, parameters Pl thru P6 must be 
set into cells PARAM+1 (X7525B) through PARAM+6 (X7532B). 
Numbers must be entered as their actual values, while letters 
are represented by their 7-bit ASCII codes. Missing parameters 


are set to zero. The parameters are interpreted as follows: 


Pl: command; C (copy), V (verify), or R (reproduce- 
copy and verify). 


P2: source disk drive (SDISK); D,E,F,G, or S. 


P3: destination disk drive (DDISK); D,E,F,G, or S. 
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P4: initial disk address (FSECT). 
P5: final disk address (LSECT). 


P6: target disk address (TSECT; initial sector 
: on destination disk drive). 


NOTE: Parameters entered for sector addresses are treated as 
decimal values unless followed by "B". 


Default values for the parameters are: 


Pl (CMD) - = 

P2 (SDISK) 

P3 (DDISK) = 

P4 (FSECT) = 

P5 (LSECT) = FSECT if FSECT is specified, 
else use 1777B. 

P6 (TSECT) = FSECT 


QHN DA 


If "D" is specified for either SDISK or DDISK, then when DUP 
is loaded it types 


DISKS READY? 


to allow the operator to place the desired disks in the drives. 

A response of "Y" initiates the specified command. A response of 
"X" causes an Executive reload via a transfer to the System 
Loader. Defining SDISK as "S" (meaning a "system" disk) causes 
drive "D" to be used, but DUP skips this question. 


When DUP has completed processing the specified command it types 


DONE 
SYSTEM READY? 


to allow the operator to exchange disks. A response of "A" 
(again) causes DUP to repeat the specified command; a response 
of "Y" causes the Executive to be reloaded via a transfer to the 
System Loader (NOTE: a "system" disk must be installed in | 
drive D). 
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If DUP is called using defaults for all parameters (RU DUP) 
the disk in drive D is duplicated (copied and verified) onto 
drive E. DUP communicates using the Console List and Console 
Keyboard (CL nad CK) units. 
ERRORS: 
If the parameters entered are in error, DUP types 
ILLEGAL eounee 
and reloads the Executive via a transfer to the System Loader. 
If an error is detected during verification, DUP types. 
COMPARE ERROR 
and proceeds to the "SYSTEM READY" question. 
If bit 15 is set between transfers, then DUP types 
ABORTED . | 


and proceeds to the "SYSTEM READY" question. 


All device errors cause SIO/XIO halts; see Section IV.C.1. 
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VIII. 


TIT.A. 


‘DPCS is an absolute program which runs in the SIO environment 


FDOS BCS PACKAGE 


In addition to the Basic Control System Drivers provided, other 
programs are needed to allow the Hewlett Packard computer user 
to take full advantage of the FDS in a BCS environment. The 
FDOS BCS package provides disk I/O facilities during the Pre- 
pare Control System process. It also provides console device 
interaction, I/O capabilities, and an interface with the SIO 
Driver package (and, consequently, with the entire FDOS system 
if desired) during the loading process. 


The FDOS BCS package contains the following modules: 
*Disk Prepare Control System (DPCS), absolute binary 
*Input/output Control (.10Cc), relocatablé binary ~- 
*Teleprinter BCS Driver (D.@%), relocatable binary 
*Cassette System BCS Driver (D.35), relocatable binary 
*Floppy Disk System BCS Driver (D.36), relocatable binary 
*FDOS Relocating Loader (RLOA), relocatable binary 
*Subroutine Library, relocatable binary 

In addition, a configured BCS file (ABCS, Absolute Basic Control 

System) is provided; this file was built using the above modules 

and hardware configuration in Section V.A. 


DISK PREPARE CONTROL SYSTEM 


The Disk Prepare Control System (DPCS) is a modified version of 
the standard Hewlett Packard Prepare Control System (PCS). 

DPCS processes relocatable modules of the Basic Control System 
and produces an Absolute Basic Control System file (ABCS) that 
is configured to work with a specific hardware configuration. 

It creates operating units of the Input/Output Control subroutine 
(.T0c), the equipment driver subroutines (BCS Drivers), and the 
Relocating Loader (RLOA). It also establishes the contents of 
certain locations used in interrupt handling. Options are 
available to define the equipment driver modules and other BCS 
system subroutines as relocatable programs to be loaded with the 
user's object program. 


using the configured SIO Driver (see Section V). The order in 
which the BCS modules are loaded and processed by DPCS is not 
significant, except that the disk BCS Driver must be the first 
module loaded and the FDOS version of the Relocating Loader 
must be the last module loaded. Two modules, the Input/Output 
Control subroutine and the Relocating Loader, require that 

the parameters be entered via the keyboard after being loaded. 
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The EQT input of IOC has been modified in two ways to handle the 
D.36 driver: first, the Unit Number can be one or two digit 

octal value in the range @ to 37; secondly, another input follow- 
ing the Unit Number has been added which defines the offset 
between the disk data channel and the disk control channel as 

a "Cc" followed by a one or two digit octal value in the range 

1 to 17. Thus, the Equipment Table Statement is of the forn: 


nn,D.ee(,D) (,Uu(u) ) (,Co (0) ) 


The first word of the FQT has been changed to assign bits 19 thru 
$6 to the Unit Number (instead of bits @8 thru 96), and to assign 
bits 14 thru 11 to the disk control channel offset. These added © 
bits (14 thru 99) were previously unused. 


In addition to the above changes, all loader diagnostics and 

completion of DPCS cause a reload of the Executive (via a 

transfer to the System reader X7544B).- c o eas, Seas 
Oe ee a Pda Bee ee i Seo ae 

DPCS is an absolute program which runs in the SIO environment; 

it uses the SIO Driver to load the various BCS modules from 

DI ane) to: WEEEG the: iam demas ECS ‘file’ (ABCS) onto DP. 


Varn = a7 2 one 
ae Pos ee 


Since the SIO Driver has been configured for the I/O aspects 
(see Section V.A), most of the initialization phase of HP's 
PCS is not required in DPCS. It should be noted that DPCS can 
be used to prepare a BCS system for a hardware configuration 
different from the one that DPCS is being run on. This is : 
possible because the ABCS file is not built in core, but on 
the disk. 


“To operate DPCS, proceed: as “follows: 


1. Since the BCS Drivers to support a hardware configuration 
defined in Section V.A are Queued on D3 of the "skeleton" disk 
shipped from the factory, it is only necessary to reassign DI 
to this unit prior to calling DPCS. This, along with obtaining 
a list’ of the modules that will subsequently be processed by 
DPCS, is accomplished by typing 


AS DI,D3;LD DI 
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The Executive responds by typing 


D.36 
D.36X 
D. GG 
D.35 
.roc, 
RLOA 


If additional BCS Drivers are to be incorporated, they should be 
copied to disk and Queued to DI preceeding RLOA. 


2. Open a file on DP to receive the ABCS file generated by DPCS, 
and call DPCS by typing 


QU DP,ABCS;RU DPCS 
~~ NOTE: Following this section is a sample dialog of DPCS. 
3. DPCS will be loaded, and will type 

FWA MEM? 
requesting the first word of available memory, i.e., the first 
word in the base page following the locations required for in- 
terrupt processing; this. word defines thesstartvcofcthe BCS system 
linkage area. Here, as with all subsequent addresses requested 
by DPCS, reply with an octal number. 
4. DPCS will type 

LWA MEM? 
requesting the last word of available memory. This word is 
usually the location prior to the protected area (e.g., X7677B), 
or the location prior to the FDOS System Loader (X7533B) so that 
the BCS system may interact with the System Loader (and there- 
fore, the entire FDOS if desired). Reply appropriately. 
5. DPCS will type 

SYS RST? 
requesting the system restart address to be used by BCS when 


returning to the SIO environment via the System Loader. Use 
X7544 (Cold start) since SIO and BCS use different in-core 


buffers .and. tables. oP eas ae tie aioe te, Seeiess 
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6. DPCS will type 
* LOAD 


informing the operator that it is ready to process a BCS module 
from the system Input unit (DI). The modules may include .IOC, 
the various BCS drivers, and the Relocating Loader (RLOA). To 
cause a module to be loaded, strike any key.on the keyboard 
followed by Return-Line Feed. The "*LOAD" message is repeated 
after each module is loaded until RLOA has been processed. 
Diagnostics are printed if certain error conditions occur during 
the loading. 


The absolute lower and upper bounds of each module within BCS 
are listed after the module is loaded. The format is as follows: 


MODULE NAME 
11111 wuuuuyu 


NOTE: For details of Input/Output Control (.I0c) and the 
Relocating Loader (RLOA) operation, the user should 
refer to the Hewlett Packard BASIC CONTROL SYSTEM 
manual, P/N 02116-9017; to A POCKET GUIDE TO THE 
2100 COMPUTER, or to A POCKET GUIDE TO HEWLETT- 
PACKARD COMPUTERS; or to A POCKET GUIDE TO INTERFACING 
HP COMPUTERS. | | gs 


7. When .I0C has been loaded, DPCS requests the information 
needed to construct the Equipment Table (EQT), the Standard 
Equipment Table (SQT), and to define the Direct Memory Access 
statement. Refer to the dialog following this section for 
examples of these. 


8. When RLOA has been loaded, DPCS requests the parameters 
needed to set the interrupt linkages for input/output processing; 
for examples, refer to the dialog following this section. When 
these have been supplied, DPCS goes on to Processing Completion; 
the final step in DPCS processing is the writing of the Absolute 
Basic Control System file (ABCS) on the system Output unit (DP). 
When this is completed, control is returned to the FDOS Exec- 
utive via a transfer to the System Loader. 
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FLOPPY DISK SYSTEM BCS DRIVER, D.36 


The FDS BCS Driver (D.36) is a relocatable driver operating in 
the interrupt environment which accesses the disk data in the 
same format as does the SIO Driver. D.36 accepts commands and 
returns status in the standard form expected by the Input/Output 
control program (.I0C). This driver is not designed to be used 
with the Hewlett Packard Buffered IOC, since that program cannot 
assure the sixty microsecond interrupt response time required 

by the FDS. 


A seperate BCS module, D.36X, is also provided. This module 
contains the Logical Unit Parameter Tables and Buffers for D.36, 
which D.36 refers to with externals to determine how many buffers 
are available and how many drives are to be supported. The 
source (SD36X) of this module is also provided so that the user. 
can edit the module to any unique requirements.' 


The commands on the following page are accepted by the driver. 
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Bits 
Ll1l1lliggggs 
54321 g 9876 Operation 
OGGHGOXxXXXXX CLEAR REQUEST 
GOGOL KXKXXXG READ ASCII RECORD 
G@OPlLReKXxKXXXI1 READ BINARY RECORD 
GPOlxXXXX1i READ VARIABLE BINARY RECORD 
OBlLOxxXxXxx DB WRITE ASCII RECORD 
GO@lOxXxXXXL WRITE BINARY RECORD 
G6GPLIixxxggil WRITE END-OF-FILE 
@P9li’xxxPll SKIP ONE ASCII RECORD 
PBBlILXxXX1 GB REWIND 
OBPlLXXX11B SKIP TO END-OF-FILE 
G@G@lixxxiilil SKIP ONE VARIABLE-BINARY RECORD 
NOTE: A read record command with a buffer address of zero 


will produce a skip-one-record of the designated type 
(i.e., ASCII, binary, or variable binary). All other 
commands are rejected by the driver. 


a 


Ci 2 


The poliGwind status returns are generated by the driver: 


Bits 
765432129 Meaning 
LxxXxxXxX XXX END-OF-FILE DETECTED 
X1lxXxXXxXXX REWIND JUST EXECUTED (AT BOT) 
XX1LlKXXXX END-OF-TAPE ON READ, DISK FULL ON WRITE 
xe Ke WRITE ERROR (OTHER THAN WRITE PROTECTED) 
ee eX eX BROKEN TAPE (SECTOR CHAINING IN ERROR) 
XXXxXxX1xXxX WRITE PROTECTED 
Re eK READ ERROR 
XXXXXXX1 - DEVICE BUSY OR NOT READY OR INOPERABLE 


Bit 14 of HQT word 2 is set for read errors and write 
errors other than write protected. 


The Driver returns to .10C. with the following conditions: 


A REGISTERS B Meaning 
SFSCGSSGC CPP HCHO OPERATION INITIATED, IN PROGRESS | 
1GGGSGK PHGKH HD OPERATION EXECUTED AND COMPLETED 
GOGKCGCL FCKPKGK BE ILLEGAL FUNCTION WAS REQUESTED > 
GSGCSGP1l LPS HP SB DRIVER OR DEVICE IS BUSY OR NOT READY 


OR A "BROKEN TAPE" CONDITION EXISTS 


T£ the EQT is incorrectly configured, i.e., illegal Logical Unit 

number or the DMA state from EQT does not match DMA state of the 

driver, then the ***FATAL*** halt at "IOERR" (in.IOC) will occur, 
with A = 3 (for misconfiguration) and B = absolute address of the 
"ISB ‘ LOC" P : 
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VIIT.C. DISK DATA I/O DURING BCS OPERATION 


Since the disk is a file-oriented device, and since D.36 has 
file-manipulation capabilities, the disk can be thought of as 
amag tape. Thus, a user program can store and retrieve data o 
on disk by using the FORTRAN Auxilary Input/Output Statements 
Of REWIND and ENDFILE as an example. However, prior to doing 
disk I/O, the file or files must be "opened" on the appropriate 
disk logical unit (the Unit Reference Numbers defined in the 
EQT during DPCS) and the Logical Unit Directory set up; this is 
anagolous to mounting the mag tape. 


This "opening" of files and LUD set up can be accomplished via 
the Queue command of the FDOS Executive prior to calling the 
user program. It. may also be appropriate to use the Reserve °° = 
File command to reduce the amount of head slewing (see QU and 
RF command descriptions in Section VI). 


During some application programs it may be desirable to have 
the same file Queued on both the Output Unit and the Input Unit. 
Thus, the user program could output an array, "close" the file 
(ENDFILE), reposition the file (REWIND), then input and process 
the array. 


A note of caution is appropriate here. The .IAR. routine of 
the standard HP formatter reads data in fixed blocks of 120 
characters (60 words) during an Unformatted Read. Thus, calls 
must be in multiples of 60 words, or input data will be lost 
(i.e., if 50 was requested, words 51 thru 60 would go to the 
"bit bucket"). Also, during Unformatted Read, the total number 
of words requested must be a multiple of 60. 
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VIILI.D. THE CASSETTE SYSTEM BCS DRIVER, D.35 


D.35 is a relocatable driver for the cassette system. [It 

accepts commands and returns status in the standard form expected 
by the Input/output Control program (I0C). This driver is not 
designed for use with Hewlett-Packard Buffered IOC, since that 
program cannot assure the 2 ms interrupt response time required 
by the cassette system. | 


The following commands are accepted by the driver: 


Bits 15 -—- 12 Operation: 
0 Clear 
1 . Read a record 


Bit 6 = 1 for binary, @ for ASCII 


2 Write a record 
Bit 6 = 1 for binary, @ for ASCII 


34° Control function: 
Bits 8 - 6 Function; 
L Write End-of-File 
3 Skip one record 
4 Rewind 
6 Skip to end of file 
7 Skip one record 


Any other commands are rejected by the driver. 


The following status returns are generated by the driver: 


Bit Meaning: 
7 End-of-file detected during read 
6 Leader detected after rewind 
5 Leader detected after operation other than «:. 
rewind 
4 Write command rejected, but not for write 


protected cassette 


3 | Not Used 
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2 Write protected cassette 
1 | Error detected during read 
g Device busy (not ready) 


End of tape status (Bit 5) can only be cleared by issuing a 
rewind command. Read error (Bit 2) and write commands rejected 
for reasons other than write protected cassette (Bit 4) cause 
Bit 14 of EQT word 2 to be set. 


THE ABSOLUTE BASIC CONTROL SYSTEM FILE 


The Absolute Basic Control System file (ABCS) was built with 
DPCS and the hardware configuration defined in Section V.A. 
The following differences exist between the Relocating Loader 
module (RLOA) of this file and the standard Hewlett Packard 
Relocating Loader: 


*Interaction is via the console device rather than 

the Switch Register ; 

*Al11 loader diagnostics cause a return via the System 
Restart Address (see Section VIII.A.5). 
*The subroutine library is a file named LIBN, LIBE, 

LIBF, OR LIBZ Queved on the library unit D4. 

*After writing an absolute binary file, or in response to 
a HALT call, ABCS executes a JMP to the System Restart 
Address (see Section VIII.A.5). 


When ABCS (of which RLOA is a module) is loaded, the message 
"OPT" is typed on the console device. The user must respond 
with one or two characters as follows: | 


"p" requests writing an absolute binary file on the 
system Output unit (Unit-Reference no. 4, normally E2), 
followed by a file (on the system Output unit) containing 
the entry point list; if a second file is not Queued 

on the unit, the entry point list is lost. 


"L" requests printing a bounds list on the system list 
device (Unit-Reference no. 6, normally E3). All other 
characters have no effect, except that they are counted 
(e.g., "Q" Signifies to the program that no options are 
desired). 


Whenever an end of tape condition (e.g., a File Mark) is 
encountered, the program types "*LOAD". At this point the 
user must type one character: (D,F,I;N,T,E..or X), and.may 


type "L" if. desired. 
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These have the following meanings: 


I = Load another file from the system Input device (as - 
defined in SQT). 


D = Proceed to the end-of-loading phase. 

T = Terminate loading. 

N = Load from LIBN (Non-EAU Library). 

E = Load from the LIBE (EAU Peasy. 

F = Load from LIBF (Floating Point Library). 


X = Load from LIBX (User-supplied library). 

L = (with any of the above) Produce a bounds list on the 
system list unit (Unit-Reference no. 6, normally E3); 
if a file is not Queuved on the list unit, the bounds 
list is lost. 


At the end-of-loading, the program types ""*LST". The user 
must type one character: 


L = Produce an entry point list on the console list 
device (Unit-Reference no. 2, normally the teletype) 


Any other character = Do not produce an entry point list 
on the console device 


Upon completion, ABCS prints the "*END" message, and reloads 
the Executive via a transfer to the System Restart Address 
(normally the System Loader "cold start", X7544B). 


BCS DEBUGGING SYSTEM . 


The debugging routine provided by Hewlett Packard as part of 
the standard BCS package is fully compatible with the FDOS BCS 
package. The user is refered to the Hewlett Packard BASIC 
CONTROL SYSTEM manual, P/N 02116-9017, for integration and 
operation instructions. 


a. 
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*AS DIsD3 
*LD DI 

D3: 

D346 

De 3 4X 
DA \ 
De35 

*LO0C. 

RLOA 


*QU DP» ABCS - 
*RU DPCS 

FWA MEM? 

oo 

LWA MEM? 
21933 

Do te 
27544 


* LOAD 
Z 


De 36 
29369" 2 1533 


* LOAD 

Z 

De 36% 

24716 25364 


- * LOAD 
Z 


De AA 
PAI60 24715 


* LOAD 
Z 


can 


De35 
P33PA C4161 


* LOAD 
ra 


Toc 


ee 


SAMPLE DIALOG FOR DPCS 


Logical Unit D3 is Assigned to DI. 
A Logical Unit Directory for DI is 
obtained to show which modules will 
be processed by DPCS. 


A file is opened on DP to accept ABCS. 
DPCS is called. 


The First Word of Available memory, the 
Last Word of Available memory, and the 
System Restart address is defined. 


DPCS is ready to process modules; "3" 
(or any character) directs it to load. 


The FDS BCS Driver is loaded and its 
bounds listed. 


The FDS BCS Driver's “externals" module 
is loaded and its bounds listed. 


The teleprinter BCS Driver is loaded and 
its bounds listed. 


The cassette system BCS Driver is loaded - 


and its bounds listed. 


TOC is loaded and its bounds listed. 
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SAMPLE DIALOG FOR 


* TABLE FNTRY 
Unit- 
Reference 
EQT? 
10+D-36sUG2Cl1 © 7 
1G62D+36s Ui »sCl LZ 
192D°36sUesCl Li 
1902D°365U35C1 +2 
105sD+-+36sU45C1 13 
145D°36sU5sC1 14 
-105D+365,U6:C1 15 
192De363U7sCl 16 
122De4@ 17 
149D¢«3.52 UG 20 
142D-35, U1 21 
142D-«35s Ue 22 
145De355U3 «93 
7E 


SOT? 
“KY BD? 
17 
oy a 
17 
“LEB? 

7 a 
~PUNCH ? 
15 
~INPUT? 
14 

pa Oy BS Bet 
16 — 


DMA? ee 
0 

* LOAD 

Z 


LOADR 
(20345 23005 


INTERRUPT LINKAGE? 


1052051-36 
112215C-36 
12+2251-G0 
132107613 
2452451635 
_4E * 


Number 


DPCS (Continued) 


The Equipment Table is defined; Logical 
Unit D4 becomes EQT entry 7, Dl becomes 
19, D2 becomes 11, D3 becomes 12, E4 
becomes 13, El becomes 14, E2 becomes 
15,°E3 becomes 16, cassette deck zero 
becomes 2%, deck 1 becomes 21, deck 2 
becomes 22, deck 3 becomes 23, and the 
teleprinter becomes EQT entry 17, 


Unit-Reference numbers are assigned to 
the units in the Standard Equipment 
Table. The Library will be D4, system 
Output (PUNCH) will be E2, system Input 
will be El, and High-speed List (LIST) 
will be E3. 


No Direct Memory Access channels are 
available. 


The Relocating Loader is loaded and its 
bounds listed. 


The Interrupt Linkages are defined for 
channels 19, 11, 12, and 14; since no . 
BCS Driver was included for the device 
in channel 13, a halt will be executed 
if an interrupt occurs on channel 13. 
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SOT - 
oFOT« 
C+36 
De 3A 
DICOM 
1-36 
RETRY 
eBUFS 
eLUPT 
eSTBL 
LOFRRR 
NRBUFS 
NLOGU 
DeAG 
To fa 
eRUFR 
D.35 
1-35 
°1O0Ce. 
DMAC 1 
DMAC? 
XSQT 
KEQT 
LST 
eLDRe 
oMEMe 
HALT 


SAMPLE DIALOG FOR DPCS (Continued) 


PAAAG 
PBALTA 
PAAAS 
25646 
25365 
26431 


P6345: 


ClIsae 


e53A4 


PATIT 
e3n 15 
PATIG 
(alga Ot aS 
24162 
24336 
e3e47 
23326 
ea tod 
23181 
233146 
RISET 
23314 


23315 ° 


20376 
220A 
22777 
22774 


*SYSTEM LINK 
AAALS ANBAI 


*ZS3RS 


He 


A list of the entry points is printed. 


The bounds of the System Linkage area 
are printed. Upon completion of the 
writing of the ABCS file to DP, the 
Executive is automatically reloaded. 
Note that ABCS is built on disk, not 
in core. After returning to the | 
Executive, we zero out the system and 
restore the I/O assignments. 


ViILI-13 


FDOS COMMAND SUMMARY 


ee ae es cee ee ee ES cory eae Sees iS me a SAO Se ne Se Se eS Gn Se Senne Set mene ees Se SS cee Se cee NN et ces ee TE ee 
ee Oe ee et ee Se ee SS a See A Se Ee De ie Se a ee OE See Se ey Se SE ee ae a SE So 


COMMAND 


Add to LUD. 
Assign. | 
“Batch. 
‘Batch Exit. 
Comments. 


Copy. 


Directory. 
Directory with 
Addresses. 

Delete. 

Dump Disk. 
Dump Memory. 
Dump Records. 


Format Disk. 
Go To. 

If Disk. 
List. 


List All Units. 

Logical Unit 
Directory. 

Queue. 

Reserve File. 

Restore. 

Rename. 

Rewind. 

Run. 

Run from speci- 
fied Disk. 

Save. 


Skip. 

Save Start 
address. 
Temp. Queue. 

Verify. 
Write. 

Write EOF. 
zero System. > 


DUNT,NAM1,NAM2,... 
FUNT, PUNT, LCTR,PGCTR 
NAME 

NAME 

Text 
SRCE,DEST,#,MODE 


DISK,DEST 


DISK,DEST 

DISK, NAME 
DEST,DISK,LO,HI 
DEST, LO, HI 
SRCE,DEST,LO,HI,MODE 


DISK 
ADDR 
UNIT 
SRCE,DEST, LO, HI 


UNIT | 


DUNT 
DUNT,NAM1,NAM2,... 
DISK, NAME,# 


DISK, OLDN, NEWN 
UNIT 
NAME,SA,parameters 


DISK, NAME,SA, parameters 
UNIT, FWA, LWA 


UNIT, # 


UNIT, ADDR 

UNIT, NAME 

SRCE, DEST, +#,MODE 
DEST,SRCE 

UNIT 


DEFAULT CONDITIONS 


None. 
LCTR & PGCTR as before. 
NAME = next file on BC. 
NAME = next file on BC. 
N. A. 
SRCE = DI, DEST = DP, 
# = 1, MODE = “ASCII. 
DEST = CL. 
DEST = CL. 
None. 
DEST = CL, LO = 2, HI = LO. 
DEST = Cl, LOv= 2, HL = Lo. 
SRCE = DI, DEST =cL, LO =1, 
HI = EOF, MODE = ASCII. 
None. 
None. 
None. 
SRCE = DI, DEST =CL, 
LO = 1, HI. = EOF. 
UNIT = CL. 
None. 
None. 
None. 
N. A. 
None. 
UNIT =DI. 
None. 
None. 
UNIT = DP, FWA = 2, 
_ LWA = FWA. 


UNIT =DI, # = 1. 


UNIT = 
None. 
(same as Copy). 


DP. 


DEST = DP, SRCE = CK. 
UNIT = DP. 
N. A. 


The following parameters are used with FDOS Executive commands: 


ADDR = octal address 

+ = number of files or sectors to process 

DEST = any functional or physical unit 

DISK. =D, E, F, or G (floppy disk drive) 

DUNT = Dl, Doz D3, D4, Bl,...,G4 (logical units of DISK) 
FUNT = functional unit 

FWA = first word address 

HI = last record or address to be processed 

LCTR = page-spacing line counter 

LO = first record or address to be processed 

LWA = last word address 

MODE = mode of data; A (ASCII), BA (absolute binary), 


or B (relocatable binary) 
NAME = name of a disk file 


PGCTR = page-spacing character 


PUNT = physical unit 
SRCE = any functional or physical unit 
UNIT = any functional or physical unit 


NOTES: Any number input which defaults to octal (disk and core 
addresses, etc.) can be followed contiguously by "I", which sets 

bit 15 before further processing. This is useful with the GO 

command; for example, to transfer indirect to the (core resident) 
DEBUG breakpoint entry use "GO 4I". | 

DISK or DUNT values can be referenced implicitly or explicitly via 
Functional Units, Physical (disk logical) Units, or disk drive letters. 


PAGE 


0020 
0021 
0022 
0023 
0024 
‘0025 
0026 
C027 
0028 
0029 
0030 
0031 
0032 
0033 
0034 
0045 
0036 
0037 
G028 
0039 
0040 
0044 
0042 
GO4s 
0044 
0045 
0046 
0047 
0048 
0049 
0050 
0051 
0052 
0053 
00S4 
0055 
0056 
0057 
0058 


O004% #01 


OCO01 
0c000 
00001 
00200 
060010 
CG012 
00014 
07600 
C7600 
C7601 
07662 
C7603 
07604 
07605 
C7606 
C7607 
07é10 
G7611 
07612 
076135 
07614 
07615 
07616 
G7617 
07620 
07621 
C7622 
C7625 
07624 
07625 
07626 
G76é27 
076350 
07631 
07632 
07633 
07634 
C7635 
07636 


063666 
073664 
102074 
017637 
102075 
017637 
102076 
1u2501 
013655 
070001 
063656 
073657 
614655 
065004 
O4COOL 
043656 


073560 . 
“002004 


GG2C04 
073664 
0607661 
163657 
027657 
173660 
057660 
006006 
027625 
102077 
063665 
162601 
127664 


SW 

A 

By 
WSECT 
ND 
CeC 
SeSK 


CONFG 


LOGP 


EGU 
EGU 
Eau 
EGU 
EGU 
EGU 
EGU 
ORG 
LDA 
STA 
HLT 
JSB 
ELT 
JSB 
HLT 
LIA 
AWD 
STA 


LULA 


STA 
AWD 


CMA 


AUDA 
ADA 
STA 
INA 
INA 
STA 
LUB 
LDA 
ISz 
STA 
1SZ 
IWwes 
JUMP 
HLT 
LCA 
OTA 
UMP 


FDOS BOOTLOADER 


1 
0 
1 
128 
1B 


123 


L146 
COKE=-2008 
eOATL 
IOPTR 
TUB 
SvCON 
Vestoe 
SkCON 
T66 
SwR 
XFAGE 
R 
eSTRT 
FETCH 
XPAGE 
THA 

B 
eSTKT 
STORE 


IOPTR 
Leoot 
FETCH,1I 
PETCH 
STORE si 
STORE 
SZB 
LOOP 
77B 
SYSO 
SkhR 
IOFTR»I 


SET CONFIGURAT 


ION POINTER 


ENTER DATA CHANNEL 


ENTER COMMAND CHANNEL 


ENABLE LOADER & SET x7700 IN § 


KEEP PAGE 


GET CURRENT BOOTLOACER ORIGIN 


SET SOURCE PTR 
CGMPUTE OFFSET 


SET DESTINATION PTR 


AND START 


USE BAS LOOP 


DONE? 
NO 


INDEX 


PAGE 0005 #01 FDOS BUOTLOADER 


0060 07637 000000 SwWwCON NOP 


0061 C7640 102501 LIA SWR GET CHANNEL 
0062 07641 013662 AND CHANM 
0063 07642 073663 STA CHAN 
0064 07643 167664 CONLP LUB ICPTReI GET NEXT ADR 
0065 07644 037664 ISZ IOPTR 
0066 07645 006003 S2BeRSS DONE? 
0067 O7646 127637 — UJMP SWCON,I YES 
0068 O7647 063662 LOA CHANM 
0069 07650 003000 CMA 
0070 7651 116001 AND Bel CLEAR CHANNEL BITS 
0071 07652 043663 IGR CHAN PUT IN DESIRED CHAN 
0072 07653 170001 STA Bel PUT IT BACK | 
0073 7654 027643 JMP CONLP ~ 
 0074x 


0075 067655 O76000 XPAGE OCT 760060 
0076 C7656 00770G ,STRT DEF START 
GCO77 O7657 000000 FETCH NOP 

0076 07660 OU00000 STORE NGP 

0079 G7661 177700 LBOOT OCT =~100 
0080 C7662 CU007T7 CHANM GCT 77 
O01 Aa7G63 OudeCltO CHAN NOP 

0082 07664 OU0G000 IOPTR NOF 

008% 07665 000014 SYSO ABS SSK 
0084 C7666 007667 ,DATL CEF DATLS 


0085 

CO8G& O7667 OU7756 DATLS DEF DN,7 

0087 67670 GO7740 DEF DD,8 

0068 7671 OO7742 DEF DD.S 

0089 07672 GU7743 DEF OD.16 

COSO «C767% CUDOoD GCT 0 TERMINATE 

OO9L* iar: ee eee 

0092 07674 007753 cCFOLS GEF. DCeVid MUST FOLLOW DATLS 
GO93 C7675 007757 DEF DC,14 

0094 Q7676 007760 DEP: DELLS 


0095 C7677 000000 OCT 0. TERMINATE 


PAGE 0006 #0 FDOS BOOTLOADER 


0097 07700 CRG CORE-1008 

00984 LOAD FILE STARTING AT SECTOR ZERO 

0099 07700 Ou2401 START CLAsRSS 

O100*%*LOAD FILE STARTING AT BLOCK SPECIFIED IN SWITCH REG 
0101 67701 102501 STARI LIA SWR 

O102* LOAD FILE STARTING AT BLOCK SPECIFIED IN A-REGISTER 
0104 07702 Ou7400 STAR2 CCB 


0104 07703 077776 STB BLKNT INITIALIZE TO READ SECTOR 
0105 O7704 054772 IGR CROCK 

0106 07705 73777 STA MXSEC 

0107 O7706 017745 RWCNT JSR RCWRD READ WORD COUNT 

0108 07707 027745 JUMP BOOTE 

0109 O7710 Qu20Ga SZA RSS WORD COUNT = ZERO? 
0110 67711 027706 JMP  RWCNT YES = IGNORE IT 
0112 O7712 001727 ALF s ALF SET COUNTER 

0112 67713 003004 CMAsINA 

0113 a7714 O73774% STA WCNT oy 

0214 07715 017745 JSB RCWRD READ CORE AGDRESS 
0115 67716 102014 HLT 146 UNEXPECTED ECOF 

O116 o7717 O70001 STA B START CHECKSUM 

0117 07720 073775 STA PTX SET POINTER 

0118 07721. 017745 NXDAT YSB RCWRD READ DATA WORD ‘ 
0119 G772e 102014 HLT 148 UNEXPECTED EOF 

0120 O7723 O44O0C ALE A UPDATE CHECKSUM 

O12. G7724 173775 STA PTXsI — STORE IT 

Q122 07725 OS7775 ISZ PTX BUMP POINTER 

JVle3 07726 GS7774 TSZ WCNT READ ALL DATA WORDS? 
0124 Q77e7 O27721 JRP NXDAT NO = READ (CRE 
0125 C7730 017745 JSB RCkRD YES - NOW CHECKSUM 
0126 C7731 102014 HLT 14B UNEXPECTED EOF 

Ole? a7732 O5yu00] CPA B CHECKSUM ZERC? 

0128 077353 027706 JMP RWCNT YES = GO ROUND AGAIN 
0129 67734 162012 HLT 126 CHECKSUM ERROR 

0130 07735 067773 BOOTE LDB HLT77 

0131 07736 024001 JMP B 


QL33xSUBRROUTINE TO INITIATE A SECTOR READ OPERATION 
0134x% (A) = DISK ADGRESS OF SECTOR 


0135 JSB SECRD 

0136% ROUTINE PERFORMS THE FOLLOWING SEQUENCE 

0137% le WAIT FOR READY 

0138 2. ISSUE READ COMMAND 

O139% 3. SET BLOCK COUNTER TOG SECTOR LENGTH IN WORDS 
O140% 4, REAC FILE "NARE" (FIRST wORD OF SECTOR) 
U141% Se READ NEXT SECTOR ADRe & STGRE IT 

C142 6, DECREMENT BLOCK COUNTER FOR EACH READ 


O143%NOk INeLiNE IN *hCWRD®,*0NC.10" TO "REWRD'-1 


PAGE GO07 HO1L FDOS BOOTLOADER 


O1454*SUBROUTINE TO READ A WCRD 


O146* JSB RWORD 
0147 % Le DECREMENT ELOCK CQUNTER 
0148» 2e INKFUT WORD 
0149% 3, CHECK STATUS & HALT Ch ERROR 
0156% YU. RETURM WITH (A) = WORDe (B) UNCHANGED 
0151 07737 Ovdo000 RWORD NOP 
0152 07740 162310 O0U.8 SFS D.N WAIT FOR DATA FLAG 
0153 O7741 027746 UME x91 
0154 O7742 142510 NieG LIA Deb INPUT AND 
0155 07743 103710 DO.i0 STC DeDe€ ACKNOWLEDGE DATA 
0156 G7744 1e7737 JMP RWORD, I 
0157 
0158*SUBROUTINE TO READ A WORD AND CHECK FOR SECTGR ENC 
0159 O778#5 GUGOCO RCwROD WOP 
0160 7746 G47776 ISZ BLKNT 
0161 OQ7747 GeT?66 JV¥P REWRYO 
0162 07750 C6A777 LDA WXSEC 
0162 G7751 Uvegds SZA«RSS 
0164 O7752 1é774%5 JUMP RCWRDeI 
0165 07753 102312 0C.10 SFS D.C WAIT FOR READY 
0166 O7754 CeE7753 JUMP x=] 
0167 C7755 GS377e2 IOR DROCH CREATE READ COMMAND 
0162 07756 163110 DR.7 cLF O.D . 
0169 O7757 lue6le DC.14 OTA EC 
O1i70 O7760 103712 £C.15 STC D.CsC 
O173 go7761 C63771 LUA SCLTH 
0172 07762 0745776 STA BLKNT SET UP BLOCK COUNT 
O173 677635 017737 JSB RWORD READ FILE "NAME" 
O174 a7768 017757 JSB RWORD READ NEXT SECTOR ADNRESS 
0175 G7765 Q73a777 STA NXSEC SAVE SECTOR ADR 
0176 G7766 0387745 REWRD ISZ2 KRCWRD 
0177 G7767 O17737 JSB RWORD 
O178 O7770 127745 JEP RCWRD,I 
6179 07771 177602 SCLTH ABS -WSECT4+2 -(BDATA WCRDS/SECTOR) 
0180 7772 020000 DRDCH OCT 20060 DISK READ COMMAND 
0151 O7773 102077 HLY77 HLT 778 . 
0182 O777% OUCOCO WCNT NOP 
0184 67775 GO0000 PTX NOP 
0184 07776 000000 BLKNT NGP 
0185 cr7777 00C000 WXSEC MOP 
0166 END 
NO ERROKS* 


OK 


PAGE 0100 #02 COMMUNICATIONS REGION 


1971 GAndd ORG.2 COU COMRG=-CORSZ-* IF PAGE TWO TOO LARGE 
L972 17812 OKE COFRG-COMSZ 

LO7 See ta hak ak aot a COMMUNICATIONS REGIGN 4 tt eR ee RAK OE ROR K 
LO74+ 
LO75eLGCATICNS LOADED w1lTA LRIVER 

1076 17517 CUMBG TGU * 

1077 175122 O46161 PFPeCIO MEF X1C.U POINTER FGR TAILORED "STO" 

1078 37514 CuUGOGO NLOGL [CP SET BY CCNFIGURATOR 

1072 17574 OULGOU ANELFS fiCP SET BY COHMFIGURATOR (FOOS FLAG) 


1080 175175 GUGCOO0 GSFLG KGP 

1Qo1 17516 Cuus00 AFLG f:bF 

L062 17517 Gi6014 PexIC LVEF XIO 
1064 17920 G13720 PeFDT PEF TeFUT 
L084 L724 013740 P.FOT GEF T.FDOT 
LUeS 17522 016017 PeDIO ErF CIO 
1066 17923 27547 ELUAL JGeF LOAD 


L087 17528 COMNE Eu *e] 

LOG8x 
LOK9*LGOCATICHS NOT LOAUED WiTH SYSTEM OR LCGADER 
19099 47524 PARKBG EGU » = 
LOOT . FER & 

1092 17524 00C000 NUP 

L092 17825 GUObUE fiGP 

109? 475826 OLoChO fOr 

2092 1417527 GuGGUG ROP 

1092 47520 CUOR0G ROP 

LOG2 37831 Uugoot NGP 

LO9P 417832 GLO09D GP 

4092 47523 CogaGG NCOP 

1993 T7545 PARHD £€GU *-1 

LONQHs . 

LO954LOCATIONS LCGADED WITH LOADER 

19G6 17534 LERBG EGU * 


4097 17534 027544 USYST UMP SYST 
1098 17535 OuD000 STKTA PSS 1 
1099 17536 OuCOoU BTCHE NOP 

lun 176857 YuGO0O LERR NCP 


LiGix* 
lice occoe ORG.3 EGU COMRGe* IF #tCOMSZ* TOC SMALL 


11043 OC00G GORGE.4 EGU *-COMRG IF *COMSZ* TOO LARGE 


PAGE 


L10S 4% 
1166« 

11074 

L1ig+4 

1109+ 

1110« 

LLils« 

oe ear 

L114 

Livia 
L225 
1116 
1117 
11ii1¢& 
1119 
12296 
1121 
Lie? 
Lie3 
Leh 
i125 
1126 
1127 
11228 
1129 
L134 
4151 
1132 
Liss 
L134 
1135 
L144 
1147 
1134 
ASS 
Lian 
114] 
L1iqe 
Li 
L144 
L145 
1146 
1147 
Liye 
1149 
1156 
1151 
1152 
L194 
L154 
A Ges 
11546%* 
1157 

115& 

1159 

L160 

1161 


“4 


0201 "92 SYSTCF LOALLER 


$A ORO ok ok Ok GRR dotRotabok SYSTEM LOADER tora aokoroboboak tp kom tok ot tok 


EXEC 
SYSwo~ 
SYST + 
LuUAD « 
STRTA 
PARST 


i 


17540 
17541 
1754e 
17543 
17544 
LyVS4S 
17546 
17547 
17550 
L7SOs 
Ti30e 
OW Gapape 
17554 
147555 
17556 
LST 
17566 
17561 
17562 
175603 
1.7564 
L765 
17566 
T1567 
17570 
175734 
1757e2 
TSS 
17574 
17575 
17576 
VTS 
17660 
47602. 
17602 
17604 
L76E04 
17605 
L7506 
17607 
T7616 
CeO 
17611 
1761e¢ 
17613 
A?Ha4 
17615 


~_ 


an 


LGAE 
LOAD 
LOUAD 
LUAD 


C/FHOS FXECUTIVE 


C/FUCS DIVERS 


C/FUUS 


PROGKAM 


S Y 3 T c iM 


STARTING AT DISK 


SPECIFIES STARTING 


LOAD ADDRESS IS STOREL Iw 3 BLFORE LOAD BEGINS 


Un SbG64 
Quet01 
063665 
Ov2o01 
Gib 46635 
CuB4 Qe 
Le Gi were re. 
O7 A676 
GLSE67 
CYSETL 
CU74 OU 
O7767e2 
GCI7T675 
OL762 
27611 
Gucdads 
De 7 Su 
GU1L727 
CUusQ04 
074674 
CL7625 
027606 
B70OC1 
Cs7&7e 
CuE001 
O/7COUS 
af 3ea74 
Q47625 
Ne 7AC& 
O44 000 
174674 
OSTS7Y 
O27673 
ve7573 
C1762e5 
027606 
06000) 
Ge27SS5 
OuS4 OG 
G/3537 


CET 544 


OAD =~ START PROGRAM 
STRTA 
STKTA 
OC 


Hoe7 535 
O7S5a5 
1677006 
N0UH0GE 
12.4001 


EXEC 


SYSW 


SYST 


LGAD 


RYeCNT 


NAXADAT 


STH1 


STRKT 


LOA 
K&S 
LUA 
RSS 
LOA 
CLE 
S18 
STA 
ATO 
STA 
CCE 
1B 
SEE 
JEL 
JEP. 
SZAy 
JP 


ADDRESS 


FXACR 
STALR 
SYADR 


STRTA 
SLCAD 
OS™hSK 
DSKBT 


STFLG 
RCWRD 
SiraAt 
28S 


RYCNT 


ALF e ALF 


CrAe 
STA 
JSB 
dheP 
STA & 
1Sé2 
RSS 
STA 3 
STA 
JSS 
ek P 
ALB A 
STA 
182 
ISz 
JP 
JSS 


JhP 


JUMP 
CCA 
STA 
JheP 


Li 
STA 
CLC 
Sc fs 


J hs, P 


TMA 
WChT 
RCWRD 
STEK1L. 


STFLG 


PTX 
PCKRE 
STR1I 


PTXel 
ETX 
WONT 
NXOAT 
KCWRD 
STR 
CRA D 
RUCINT 


LERR 
SYST 


Rel 


CLEAR START ADDRESS 


ADDRESS IN A 


INITIALIZE 
WORD COUNT 


READ 
EOF 


WORD COURT 


YES 


LGW 


SET COUNR 


READ CORE. ABDRESS 


WORD READ s 


= ZERG? 
ORE JT 


UNEXPECTED EOF 
START CHECKSUM 


SET 


POINTER 


READ DATA W 
UNE XPECTEG 

UPLATE CHECKSUM 
STCRE IT 
BUMP POINTER 


READ ALL DATA wORDS? 


NO 
YeS 


Saal 


Saal 


READ 
VOW 


QRD 
EOF 


MORE. 


CHECKSUM 


UNEXPECTED EGF 


CHECKSUM | 
YES = GO RGUND AGAIN 


ERROR 


Ze 


SET 


LOAD SYSTE™ 


(A CLEAR FROM 


RO? 
FLAG 


COLD 


EOF) 


REGISTER 


NO WORDS 


(COLD) 


C WARM 


PACE 90102 £06 SYSTEM LCANLR 
1162 17614 1240903 JUMP 3eI 
11l634aSULROQUTINE TC READ A tOokKD 
11644 JSB FPROURD 
1165% 1. DRCROFERT BLOCK COUNTER 
11664 ee INPUT KORD 
Lle7s 4. CHECK STATUS & HALT ON ERROR 
Lies. G,. RETURN WiTr (A) = wWORUe (8) UNCHANGED 
1169 176177 G0OOLG RRURE wKoCR 
1170 17620 1uz3510 Ob.9U StS £,D WAIT FOR DATA FLAG 
1171 27621 C27620 JuP *=1 
1172 47622 10u251U DO.91 LIA NeD INFUT AND 
Li7S £723 LUSTIG Ob,9e SiC Lehat ACKNOWLEDGE CATA 
1174 47624 127617 Jue RWORU, I 
LI75* 
117K64SURKOUTINE TO READ A vURD « GR IF NEED. 
4177% START A NEW SECTOR FEAL OPERATION 
1178 17665 Guogeo RKCWROE NGF 
1172 17626 G47675 ISZ BLENT 
11460 17627 Gée7657 Jee RE RRD 
11¢]1 17630 C6HZ676 LEA NXSEC 
1142 17531 GUpPdaUS SZAshKSS 
1184 17632 127625 JEP RCWRGeL 
11864 17633 053671 1OR CSKBT 
1165 17634 O7 4676 STA SECAD SAVE SECTOR ADDRESS 
Jlwé 37625 luv514 6C.96 LIA LLC 
1167 17636 013676 Ais LRDYS 
1188 47687 OUeu0s SZAsRSS 
J169S 17640 627635 JEP x93 
1190 17641 U6s66e2 LiA SCLTH 
191 176428 0735675 STA BLKNT SET UP BLOCK COUNT 
1192 17643 Uo3676 WROY LEA SECAD 
21193 17644 0434666 AGA LROCM CREATE READ COMMAND 
$194 17645 1u311G bO.S3 CLF G.D 
L195 17646 102601 Soe GIA SR DISPLAY COMMAND 
1196 17647 162614 mC.91 CTA D.C 
1197 17450 1u3718 oOF.92 SIC B.C.C 
1198 17651 1462514 bC.93 LIA B.C READ STATUS 
1139 76852 fo1elV RELL SLA KEADY? 
1200 17653 G27645 JEP NRDY NO 
L201 17654 G17617 JSB - RwGRD REAG FILE "NAME" 
Leo2 17655 047617 J5B8 RKORD READ NEXT SECTOR ADNRESS 
1203 176564 0745676 STA NXSEC SAVE SECTOR ADK 
L264 17657 UdS7TeecS REWRE 1S2 RCWRD 
1265 17660 017617 USB FPWGORD 
1266 17661 127625 JRE RCWROeI 
Le07 37662 177602 SCLTH ABS -WSECT+2 ~(DATA WORDS/SECTOR) 
1208 17663 GULUO1S SYADR AES S.C TRACK & SECTOR GF SYST 
1209 17664 C0001? EXADK AGS SLX TRACK & SECTOR OF EXEC 
1210 17665 OUOM1G SITADK ALS §.S] TRACK & SECTOR OF SYST 
J211 176866 OeéCOluU LRDCK oct 2noog DISK READ COMMAND 
1212 17666 DROCM £GU LRECN 
1215 317667 046000 bOSMSK OCT 6G0U DISK BITS 
1214 17667 MOISK EGU DSMSK 
1245 17670 040000 LKLYS GCT 4huuO FORMATTER READY BIT 
1216 17676 REUYST Eeti LKDYS | 
1217 17670 DkRCM EGU RLYST WRITE COMMAND 
l2@ie 17671 QvLOOEGE fSo.d 


DSnBI 


C-3 


PAGE 0105 #02 


121¢ 
122N 
Jeez) 
1222 
1223. 
lee4u 
L225 
L22é6 
L22é7 
1228 
1229 
Lest 
125i 
Le Sex 
7 1e 35 
L25uU% 
Veo8 
1236% 
1237 
125k 


17e71 
17e7ve 
17672 
176734 
17673 
7.74 
J7a74 
17675 
17675 
17076 


PTET: 


L7e76 
L7RAT 


17677 
176577 


Candd 
GO006 


SYSTEM LOAGLR 

DSbGUF EGU OSKET 

NGC000 STFLG ESS 1 
DERKCHK EGU STFLG 

0UGG00 bkENT ess 1 
SCCNT Eul bWCNT 

CUdH0CO PIX eS) id 
TetbUF Cou PTX 

Q00000 BLKNT ESS 1 
RTKYC LGU BLKNT 

OG0000 WXSEC FES 1 
SECAU EGU MXSEC 
SCAOR EGU SECAD 
el eX ECL RWORD 

LuUcO77 HALT HLT 776. “A SYSTEM PRE-BOOTLOABER HALT 
LORNE EGU #el 
ORGe.S EGU CORE+77U0G-* IF LOADEK TOG LARGE 
ORGeG EGU 


*=CORE-7700B8 IF LOADER TOO SKALL (CtHALT®*) 


INTERFACE DESCRIPTION 


The model 420 Floppy Disk System (FDS) is interfaced to the 
Hewlett-Packard 21XX Series computers (2100, 2114, 2115, and 2116) 
via two identical interface cards (Dicom Part Number 520-50052- 
02). The interface cards can be installed in any two available 
I/O channel slots. The highest priority (lowest numbered) 

channel is used for data transfers; the other channel is used 

for command and status transfers. The FDS interface supports 
programmed I/O, anceE eae environment, and DMA operation (16 
bit). 


Since the FDS is a block-synchronous device (data transfers 
must occur every sixty microseconds once initiated), a high 
priority should be used for the data channel when operating in 
the interrupt environment in order to avoid rate errors. 


An OTA (or OTB) instruction is used to transfer commands and 
data to the FDS; an LIA (LIB, MIA, Or MIB) instruction is used 
to transfer status and data from the FDS. After executing the 
T/O instruction, control must be set and the flag cleared for 
that channel (select code); thus the proper sequence is OTA 
followed by STC,C; or LIA followed by STc,Cc. 


The POPIO line generates an initialize to the FDS; thus the 
FDS is initialized when ene PRESET (or EXTERNAL PRESET) push- 
button is depressed. 

Following is a definition of the command and status bit assign- 
ments for the FDS. 


COMMANDS (true when set in A/B before OTA/B) 


Bit NAME FUNCTION 


L5 RESET | Initilizes FDS; positions to 
| track zero. 

14 WRITE Select write operation 

1:3 READ Select read operation 


NOTE: If bits 13 and 14 are both 
zero upon receipt of STC, no read 
or write operation will be attempted; 
this allows selection of a unit for 
status testing. 


4 


12 A, tt Wot used 


11 
and UNIT 
10 


09 
thru TRACK 
04 


03 
thru SECTOR 
00 


Specifies unit number (unit D 
= £@%, unit E = Zl, unit F = 19, 
unit G = 11) 


Specifies track number 


Specifies sector number 


STATUS (true when set in A/B after LIA/B) 


BIT NAME 


15 NOT READY 
(DRIVE) 

14 FORMATTER 
NOT BUSY 
(FORMATTER 
READY) 

L3 DATA 
ERROR 

12 WRITE 
PROTECT 

11 RATE 
ERROR 

10 TRACK 
ZERO 

09 

thru 

00 


FUNCTION 

The selected disk unit is not ready. 
The unit is not ready if the power 
is off, if no disk is installed, 

or if the disk is not up to speed. | 


The FDS is not currently executing 

a read or write operation, nor is it 
seeking a new track. The FDS will 
ignore any commands given when this 
bit is not set. 


An error (parity error) was detected 
by the FDS when reading a sector of 
data. This bit is reset by a new 
read or write command. 


The disk in the selected unit is 
write protected except when a read 
operation is in progress (Read and 
Formatter Busy). 


A data request has not been serviced 
within the allowable sixty micro- 
second window. 


The selected unit is positioned to: 


track zero and the formatter is not 
busy. 


not used. 


j 
so 


INSTALLATION OF HARDWARE 


The Model 420 Floppy Disk System is interfaced to the Hewlett 
Packard 21XX series computers via two identical interface cards 
(P/N 520-50052-02) and a "y" cable which interconnects between 
the interface cards and the baseplane wiring in the FDS enclosure 
containing drives D and E. In the "standard" software configura- 
tion, channel 10 is used for data and channel 14 is used for . 
control/status. Installation of the hardware consists simply of 
plugging in the interface cards and installing the cable: 


1. Unpack the FDS from its shipping box. If shipping 
damage is noted, notify the carrier (see note in the 
shipping box). 


kKER*KE ERE K RK CARARUTION* *€ *¥ & KK 
* 


2s 


* 

* ‘ 

* OPEN THE LOADING DOOR OF EACH DRIVE AND * 
* REMOVE THE SHIPPING INSERT BEFORE POWER * 
* IS APPLIED. IF THIS PRECAUTION IS NOT * 
* TAKEN, DAMAGE TO THE DRIVES MAY RESULT. * 
* * 
* * 


ke Kk KF RF RR KR RK RK KB Rk Rk RK RK RK RK KR KR 


3. With the computer power off, install the 520-50052-02 
interface cards in slots 10 and 1l. Install the cable 
connector labeled "DJ2" onto the card in slot 10; install 
the cable connector labeled "CJ2" onto the card in slot ll. 


4. If a cassette system is to be used with the "standard" 
FDOS software, install its interface card in slot 14 and 
cable it up to the cassette system. If a cassette system 
is not used, install a card in slot 14 to complete the 
interrupt chain. 


5. If the HP-supplied BUF'R'D TTY REG (teletype interface 
card) is to be used, install it in slot 12; connect the TTY 


cable to the card. If it is not used, install a card in 
slot 12 to complete the interrupt chain. 


6. If the photoreader is to be supported under the "standard" 
FDOS software, install its interface card in slot 13 and 

cable it up. If it is not used, install a card in slot 13 to 
complete the interrupt chain. 


7. Apply power to the computer, TTY, and FDS. 


8. Place blank disks into the drives and Bootload the Disk 
Exerciser tape supplied. Configure, define the parameters, and 
start the Exerciser per the instructions in Appendix F. The 
Exerciser should produce a regular incrementing pattern in the 
Switch Register lights as it writes, reads, and compares; bits 

ll through @@ indicate the-last disk address that was accessed 
(see the INTERFACE DESCRIPTION Appendix of this manual). Setting. 
bit 15 of the Switch Register causes an error summary to be 
printed on the console device. 


“os After the hardware has run successfully for a while, install 
the software. 
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O0OS6#1NSTRUCTLONS 

0037» LGAD PKOGRAY g START AT 2. PROGRAM COMES TO A SERIES CF HALTS 
0034+ WHICH WAIT FOR SwiTch KEGISTER INPUT. SET S APPROPRIATELY & RUN. 
GC039% REFGRE EACH FALT AFTER THE FIRST. A PROMPTER MESSAGE 

O0GG+ APPEARS ON THk CONSGLE OUTPUT DEVICE TO REMIND 

00414 THE OPERATOR WRICH PARAMETER IS SOUGHT. 


GO42» HLT 72B3 ENTER CHANNEL OF CONSOLE OUTPUT DEVICE. SET 

UVOUBs BLT 15 LF INTERFACED THRU A RICCM 344 MFCK ZERO. 
OOGYy * (WOTE: TO USE SOhkt OTRPER OUTPUT DEVICEe SET THE AGERESS 

DOYS OF THE SIO ORIVER IN 1028 

VO4B-« 

G04 7 * HLT 73Bs ERTER DIiSk CATA CHANNEL. 

UO4K + 

004% HLT 74Rs ENTER biSk CCNTROL CHANNEL. 

9050 

CO51+* HLT 75B% ENTER COMPUTER TYPE (FOR TIMING) °& 

OOSP* Ut 2IQCA 

OO054% 148 PLI4HA ¢ 2115 

OOS4»: Lon 216 

0055% 

O056% HLT 766: ENTER DRIVES TO TEST/ & PERMANENT CPTIONS 

0957% BIT DRIVE 

005&x 0 N 

GISd% 1 E 

0060 2 F 

OGb1* 5 G 

DOBeE* SET BIT 15 TG SUPPRESS TESTING OF INTEPRUPT 

C0G3*« SeT SIT 14 TO REMAIN IN WRITE PORTION CF CYCLE 
O064% SET BIT 13 TO REMAIN IN READ PORTION GF CYCLE 
0005 SET BIT 122 TG REMAIN IN INTERRUPT PORTION OF CYCLE. 
00GEGe — SET BIT 11 TO RUN THRU THE VARIOUS COMPINATIONS OF 
00G7* HEAD FLOPPING & RANDOM AUGDRESSING AUTGMATICALLY. 
0068%* ; 

006°% HLT 77R: ENTERING OF PARAMETERS IS COMPLETE. PLACE SCRATCH 
0O070% DISKS INTU THE SPECIFIED DRIVES: SET SWITCHES 
OO071L*% (SEE WNEXT PAGE) AND RUN. 

OO7O% (WOTE? TO RESTART wITHOUT CHANGING PARAMETERS+ START AT 20008. 
OO72% TO RESTART AT HLT 768, START AT 20018.) 

OO74+ 

OO75% wee NeBed EVERY SECTOR OF THE SCRATCH DISKS WILL BE WRITTEN ON 


OO7E4 | DO NOT LEAVE GOOD DISKS IN THE DRIVES. 
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OO7h* 
00794 
OOUN» 
N0G1* 
ONRP» 
003% 
OOKu« 
00u5% 


O08G . 


0087». 
VO&Bs 
0089% 
O0S0* 
GO914. 
00S?2% 
0092% 
D094» 
0095% 
0096» 
C097» 


O0°&>- 


0099% 
01064 
Q104» 
DiG2e>* 
O1G3% 
01642 
G105% 
0106% 
ULO7T 
O106% 
O100% 
Q110% 
Q111 
DIP» 
G113% 
Q1li4s# 


GCOS 


HUKING THE COURSE OF QPERATION, SWITH REGISTER BITS 11*0 DISPLAY 


fOl FOS EAERCISER INSTRUCTIONS 


THE OISk ALORESSe AS FOLLOWS? 


BITS 


17S 11 


PITS Ge4 


“193 DRIVE (CODED AS ABOVE UNDER HLT 766) 
TRACK 


BLTS 3-0 3 SECTOR 


15-12 AKE USED EOR CONTROL PARAMETERS! 


LT 15: 


BIT 14° 


BLT 19% 


(WOTE¢ 


PRINTOUT CONTROL. 

IF FRINTGUT IS NOT GOING ON. SETTING PIT 15 
WILL CAUSE AN ERROR SUMMARY TO BE PRINTED 

(SEE BELGW)e 

Yt IT 1S GOING Giiy SETTING BIT 15 WILt STOF IT. 


(NOTES BIT 15 TS AUTCMATICALLY CLEAKED AFTER SEING 


TESTED, GN MACHINES WITH TOGGLE SWITH REGISTERS, 
THIS MOST BE DONE MANUALLY.) 


RANDOM AGCDRESSING,. 

THIS PIT IS TESTED AT THE START OF EACH PASS, IF 
SET+ A PSEUDORANDOM ADDRESSING SCHEME IS USED: 
OTHERWISE THE PROGRAM PROCEEDS SEGUENTIALLY THRU 
EVEN SECTORS: THEN THRU ODD. 


FLOP WRITIKG. 

THIS BLT IS TESTED BEFORE EACH WRITE OPERATION 
IF 17 IS SET: THE PROGRAM DELAYS LONG ENOUGH TGC 
CAUSE THE DISK READ/WRITE HEAD TO BE RETRACTED. 


FLOP READING. , re 
THIS G1T IS TESTED BEFORE EACH READ OPERATION. 

IF IT 1S SET, THE PROGRAM DELAYS LONG ENOUGH TO 
CAUSE THE DISK READ/WRITE HEAD To BE RETRACTED. 


THE DELAY USED IN FLOP READING GR WRITING JS USED 
BY THE TIMING SET UP AT HLT 78B OF THE PARAMETER 
SETTING PROCESS AND BY THE NUMBER QF REVGLUTIONS 
(THE CORSTANT IN NREV) THE HARDWARE IS EXPECTED 
TO wAIT BEFCRE HEAD RETRACTION. 
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O116% 
01174 
Olle 
O0119% 
G1icns* 
Olz1% 
O1l20% 
Olea 
OLE4* 
0125% 
O126% 
Ole7*# 
O1L28* 
01294 
O130» 
O1l3i# 
O1lSe™ 


OL354% 


V134« 
0145 
OL36% 
C1is7* 
0138% 
ULS os 
O21 iy (} 
O14i1% 
O142% 
Gigs 
OLggs 
G1lays* 
OLG 6» 
OLG 7% 
O014e8% 
O14 Gs 
0150+ 
QO1Si* 
O01Se» 
O0153% 
O154% 
O155% 
O156% 
O157% 
VI5a» 
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THE EXERCISE CYCLE PhGCEECS aS FOLLOWS: 


1s 


N 
r 


A wRITING PASS 1S MADE, IN wHICH EITHER RANDOM 

LP SEQUENTIAL ADLREESSING IS USED TO wRITE ALL THE 
SECTGRS (CKANDGOPM MORE) OR ALL THE EVEN OR ODD SECTORS 
(SEGULNTIAL MOLE) OF EACH OF THE OKIVES BEING EXERCISFO. 


THE FATTECRN WRITTEN INTO A SECTOR IS COMPOSED GF 
lo COPIES GF TRE FOLLOWING 8 WORDS: 
WORE Le 1leseSe8 (CONTENTS OF EXFPT) 


WCRDO 28 DISk ACDOURESS (AS IN SWITCH REGISTER DISPLAY) 
WORG 33 HIGH ORDER WOKD GF DOUBLE PRECISTON FASS COUNT. 
WORD Yi LO GRDER wORD OF PASS COUNT. 

WORE Ss COMPLEMENT GF BORD 1 

WCRO 6s CCRPLEMENT OF WORD 2 

WORD 7s COMPLEMENT OF WCRD 3 

WORD &¢ COMPLEMENT GF WORD 4 


A READING PASS IS MADE. IN WHICH THE BLOCKS WRITTEN 

LURING THE WRITING PASS AkE READ AND THEIR CONTENTS COKPARE 
WITH THE DATA SUPPOSED TO KAVE BEEN WRITTEN. A COMPARE 
EKROK FRInNTCUT OCCURRS IF THEY ARE NOT IDENTICAL. 


A TEST OF TRE IfTERRUPT OPERATION IS PERFORMEG. THE TEST 
SEGUENCE PROCELOS AS FOLLOWS: 

Ae STCeC ON PATA & CONTROL CHANNELS. THEN CLC 0 AND STF 
Ok PATA & CONTROL CHANNELS. AN INTERRUPT Ch EITHER 
PRGDUCES AN ERRGR MESSAGE. . 

Be STEP A IS REFEATED WITH CLC ON BATA AND CONTROL 
CHANNELS REPLACING CLC Oe ‘ 

Ce THEN STC & STF ARE PERFORPED ON THE DATA ARD CONTROL 
CHANNELS. FAILURE. OF ELTHER TO TNTERRUPT CAUSES AN 
ERROR TO BRE PRINTED. . 

De. A CLE O ITS PERFCRMED,. THEN A READ OF TRACK ZEROe SECTOR 
ZERQ OF THE FIRST GISK UNDER TEST IS INITIATED RY MEANS 
OF AN STC.C ON THE CONTROL CHANNEL. WITHOUT THe STC 
ON ThE CATA CHANNEL s NGO FLAG INTERRUPTS SHOULD OCCUR. 
THE FROGRAM WAITS ONE SECOND, THEN CHECKS TC SEE THAT 
THERE WAS A CONTROL INTERRUPT. NO FLAG INTERRUPTS. AND 
THAT KATE ERROR STATUS WAS SET. 

Ee STEP D IS REPEATED WITH INTERRUPTS ENABLED BY STCc«C 
GN THE CATA CHANNEL, THE PROGRAM WAITS GONE SECOND. THEN 
CHECKS THAT THERE WERE 128 FLAG INTERRUPTS. A CONTROL 
INTERRUPT AND NRG ERRGR STATUS, 
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0166 
O16e1+ 
O1ge%* 
0164 
Ol6E4* 
OLGE5* 
O1lbE»% 
0167% 
Q16R» 
0169% 


OTN — 


OL7i* 
01724 
O17a« 
OL74% 
OL75« 
O176* 
OL77+ 
V1LTB« 
VIVO 
O1eaN* 
0161% 
O162% 
O18 4% 
O1654% 
Nigh 
OLEG* 
O187% 
OLSh » 
OL3O% 
G190« 
G191* 
01.92»: 
O1G3% 
0194 
C1S5% 
0196" 
0197+ 
0198x 
G199*% 


NGG7 ta FD 


CURING THE 
ARE BMALNTAL 
GUT 3 
1. PASS 
CYGLE 
ee WUMBE 


Se NURPRE 
ERRGKE 
FLAG 
CORE 
UNLES 


Ge WUMERE 
HAR() 
SOFT, 
NGN-Z 


5. WUMBRE 
TRE WN 


TRE ABOVE E 
TO THE SETT 
FRINTOUT FO 


WHENEVER A 

THE CASK. T 
PRINTED, FO 
BASIC 8 WOK 
BY THE ACTU 


NOTES 3 

de TF 
REM 
PRI 

Ze BEF 
AB 
ITs 
FEY: 


O2004THE PSEULDO-RA 
OPGL#FOLLOWING ALGGRITHH: 


0202% 
O20 4% 
O2U4% 
O205* 
0206 
0207% 
VE08% 
0209 
O21M» 
VeL1% 
De212« 
O2L3* 


AT ThE STAK 

YO = BIT 
& LOOP INGE 
CONTAINED O 
IS 17 fFIMES 


A TABLE GF 
SECTORS IM 
TRACK 
SECTOR 
ORIVE 


Woy 


CS EXERCISCK INSTRUCTIONS 


OFFRATION OF THE EXERCISERs CERTAIN COUNTS 
NEO. DURING AN ERROR SUMMARY THEY ARE PRINTED 


NUMBER. THIS TS THE NUMBER OF TIMES THE UXERCISE 
HAS BEEN. STARTED. 
KS GF SECTORS WRITTEN AND READ. 


KS OF WRITE FLAGS AND READ FLAGS MISSED. THESE 

S CCCUR RKHEN AN EXPECTEO READ OR WRITE DATA 

DOES NOT APFEAR AFTER A SUITABLE WATT. (CFLAGS SHOULD 
EVERY 60 MICROSECONDS.) THESE ARE NOT REPGRTED 

S THE WUMELK IS WON-ZEROQ. 


KS OF SOFT AND HARD FEAD ERRORS. AN ERROR IS 

IF IT FERSITSTS THRU THREE TRICSe OTHERWISE IT IS 
THESE ARL WOT KEPORTED UNLESS THE NUMBER IS 

ER Ge 


R OF COMPARE ERRORS. THESE ARE NOT REPORTED UNLESS 
UMEER JS WONeZERG. 


RROR SUMMARY IS PRINTED IN RESPONSE 
ING OF BIT 15 OR AS THE FIRST PART OCF THE 
LLOWING A COMPARE ERROR (SEE BELOW). 


COMPARE FRROR GCCURS A MESSAGE SFECIFYING 

RACK AND SECTOR (THE LATTER TwG IN OGCTAL) IS 
LLOKED BY AW ERROR SUMMARY. THEN TRE 

ES GF THE SECTGR PATTERN AKE PRINTEDe FOLLOWED 
AL 126 WORDS Ih THE READ BUFFER, 


FEWER THAN 228 WORDS ARE PRINTED. ALL OF THE 
AINING WORDS ARE IGENTICAL TO TKE LAST ONE 
NTED. 

CRE READING, THE READ BUFFER IS FILLED WITH 
ACKGROUND OF 146314B (THE CONTENTS OF CLRFT). 
APPEARANCE IN THE PRINTOUT WOULD INDICATE 

EK THAN 128 WORDS READ. 


NDOM ADDRESSING SCHEME WORKS ACCORDING TO THE 


1 CF THE FASS, I0 8 JO ARE SET AS FOLLOWS? 

S 5G CF RPASCTe JO = BITS 4-1 OF PASCT. 

xX WHICH RUNS FROM 0 TO THE NUMBER MINUS 1 OF SECTCRS. 
fh TRE DISKS ULER TEST IS KEPT. A VARIABLE "INGEXK" 
THE LOOP INDEXs MODULO THE TOTAL NUMBER OF SECTORS. 


64 TRACKS IN "KANDOM" ORLER (TKTBL) AND A TABLE OF 16 
MRANCOM" GRDER (SCTBL) ARE KEPT. 


TKTBLCIO)+TKTOL (1) ¢ KHERE I = BITS 9-4 OF INDEX. 


SCTLEL(JO)4+SCTRL (JU). WHERE J = BITS 3-N OF INDEY. 
DRETEL(K) WHERE K = BITS 11-10 OF INDEX & DRTRL IS A 
LIST OF THE DRIVES UNDER TEST, 


INSTALLATION OF SOFTWARE 


The "standard" FDOS software package is supplied with a fixed - 
configuration of I/O channel assignments and memory size (see 
Section V of this manual). The software package is supplied on 
the "master skeleton disk" containing the following files: 


SYS LIBE DUP , D.35 
SYS1 LIBF DEBUG .roc. 
SYS2 CODSK EXER RLOA 
SYS3 EDIT : ABCS SD36X 
SYSM ASMBN DPCS ASMBE 
SRCE CROS D.36 ASMBF 
FSRC FORT D.36X FOR2E 
LIBN FOR2N D.Gg 


The SYS@, SYS1L, SYS2, SYS3, and SYSM files are discussed in 
Section V; the EDIT, ASMBN, ASMBE, ASMBF, CROS, DEBUG, DUP, 
FORT, FOR2N, and FOR2E files are discussed in Section VII; the 
LIBN, LIBE, LIBF,. ABCS, DPCS, D.36, D.36X, D.@%, D.35, .IOC., 
RLOA, and SD36X files: are discussed in Section VIII; EXER is 
‘discussed in Appendix F. FSRC is the source of a FORTRAN pro- 
gram to be used later in this section; CODSK will also be dis- 
cussed later in this section. 


SRCE is the source of an assembly language demonstration. pro- 

gram that flashes the Switch Register lights and rings the 

console device bell. Upon execution, the program will type 
COMMAND? TYPE L, R, F, C, B, ORS 


the following responses are valid: 


L (left) - turn on the LSB light of the Switch Register 
and rotate it left for approximately 30 seconds. 


R (right) - turn on the MSB light of the Switch Register 
and rotate it right for approximately 30 seconds. 


F (flash) - flash the Switch Register lights for approxi- 
mately 30 seconds. 


C (count) - do a binary count in the Switch Register for 
approximately 30 seconds. 


B (bells, lights, etc.) - turn on the Switch Register 

lights one at a time; when they are all on, print an up- 
arrow and ring the console device bell; turn off the lights 
one at a time; repeat this cycle five times. . 
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S (system) - go to the core-resident System Loader and 
reload the operating system. 


The following narrative describes the installation of the 
"standard" FDOS software package, and gives examples of opera- 
tional procedures. Prior to installing the software, the user 
should study the preceeding sections of this manual. 


A. Install the FDS hardware and run the disk Exerciser 
(see the INSTALLATION OF HARDWARE Appendix of this manual). 


B. Install the "master skeleton disk" supplied in disk drive 
D (the left-hand drive of the main FDS enclosure). 


C. Install the FDOS Bootloader into the protected area 
of memory; (see Sections V.C and V.D of this manual). 


D. Execute the Bootloader at X7799B; a Halt 77B indi- 
cates a successful load of the System Loader. A Halt 
12B or 14B indicates an error was made in loading: 
verify that the Bootloader was entered correctly and try 
again; verify that the hardware is working correctly 

' by running the disk Exerciser. 


E. Execute the System Loader, thus loading the remainder 
of the operating system (see Section V.E); this is accom- 
plished by merely pressing RUN. Note that the Switch 
Register displays the last disk command and address trans- 
mitted to the FDS; refer to the INTERFACE DESCRIPTION 
Appendix of this manual. 


F. When the console device bell rings and an "*" is 
printed, FDOS is "on-the-air"; control of the computer 
and associated peripherals is under typed commands (refer 
to Section VI of this manual). 


At this point, one should make a copy of the "master skeleton 
disk" and file the "master skeleton disk" away for back-up 
purposes. This can be accomplished (on a two-drive system) as 
follows: 


A. Install a disk (to become the "master working disk" in 
drive E. . 


B. A disk that is used for the first time in FDOS must 

be formatted, since its sectors are not set up for use 

by FDOS (see Format Disk command in Section VI); formatting 
this disk can be accomplished by typing "FD E". It takes 
approximately thirty seconds to format a disk. 
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C. Now copy (and verify) the "master skeleton disk" by 
typing 


RU DUP 


It takes approximately forty-five seconds to copy and 
verify the entire disk (131K words) using DUP; see 
Section VII.F for a description of the Disk Utility 
Package. 


D. Remove the "master skeleton disk" from drive D and 
put it away; take the disk from drive E and install it 
in drive D. Use the ZS command to clear the buffers. 


The above exercise demonstrates calling a program from disk by its 
name. Remember that all of memory (except the Bootloader and Sys- 
tem Loader areas, X7534B through X777B) can be used by the called 
program, Since FDOS is a "disk-resident" operating system. 


Now we are going to assemble the SRCE file. Place a virgin disk 
in drive E and format it. 


The FDOS processors (ASMB, EDIT, etc.) use the units referred to 
in the base page pointers (191B thru 194B) for all input and 
output; these are analogous to DI, PL, DP, and PK (see Sections 
IV.C.2a, II.D, and II.E). In order for the Assembler to process 
SRCE, the I/O units must be prepared prior to calling it. Basic- 
ally, this is done by temporarily assigning the input unit (DI), 
and "opening" files on the output unit (DP) and high-speed list unit 
(HL). One might think of this as mounting the paper tape of SRCE 
in the photoreader, loading the high-speed punch with tape (to 
accept the binary output), and loading the line printer with paper 
(to print the listing). Since SRCE is already Queued as the first 
file on Dl, this I/O unit prepration can be accomplished with the 
following commands (we'll use the names DBIN and LIST for the 
binary and listing, respectively, of the demo program): 


AS DI,D1 
QU DP,DBIN;RF E,DBIN,2 
QU HL, LIST;RF E,LIST,41 


Files are reseved (RF command) for DBIN and LIST, since the assembly 
Will go much faster if these files already "exist" on the disk; this 
is because the driver does not have to go back to the Free Storage 
List (on track zero of the disk) each time a sector is written out. 
Now call the Assembler by typing | 


RU ASMBN, ,K 


The EAU version (ASMBE) or Floating Point version (ASMBF) of the 
Assembler could have been used, but SRCE does not use these main- 
frame options. In the above call, we have directed the Assembler 
to take its Control Statement from PK. Thus, when it is loaded 
it will type 


TYPE ASMB CONTROL STATMENT: 


To direct the Assembler to generate a binary file on DP and a 
listing and symbol table on HL, then automatically load the 
Cross-Reference Table Generator and generate a cross-reference . 
table on HL, type 


ASMB,A,B,L,T,C° 


A two pass assembly is done automatically on SRCE, generating 
the binary and listing on disk; this is possible since the 
computer has complete control of the I/O media and can re- 
position to the beginning of SRCE (no operator intervention 
is required as with paper tape). 


The absolute binary output of the assembler will be written in 
DBIN, and the listing, symbol table and cross-reference table 
will be written in LIST. When the assembly and cross-reference 
operation is completed, control is retuned to the user at the 
console device keyboard cy) via a transfer to X754@B (see 
Section V.E). 


Note that this entire operation can be accomplished in approxi- 
mately eighty seconds (by a good typist). To illustrate how 
FDOS increases the productivity of the computer system, consider 
the following: 


*On a computer system with only a teleprinter (ten 
character per second I/0), it would take approximately 
thirty-two minutes just to get. a binary paper tape (no 
listing or cross-reference). 


*On a computer system with high-speed paper tape I/O, 
it would take approximately five minutes just to get 
the binary paper tape. 


*FDOS is thus twenty-four times as productive as the 
system with just a teleprinter, and 3.75 times as 
productive as the high-speed paper tape system. 


*To actually print the listing, symbole table, and 
cross-reference table on a teleprinter, it would add 
approximately 18.5 minutes on all three systems (a line 
printer would be nice). However, on FDOS we have all 
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this on disk, and can print it later (at night?) when there 

is less demand on the computer. Also, once initiated, the 
Operation on FDOS does not require operator presence. A note 

of caution, however; listings (by nature) require a great 

deal of storage, and may clutter up the disk. One might 

direct them to cassette or high-speed paper tape. Then(with 
either media) they could be dumped to a Teletype or line printer 
at an off-line print station; this would further decrease the 
demand on the computer. 


To execute the program we just assembled, type 
RD E,DBIN 
To reload and return to the Executive type an "S". 


Now we are going to compile the FSRC file using the FORTRAN 
Compiler. First, prepare the I/O units (DI is still assigned to 
D1, since the return from DBIN was to X754@B, not X7544B - - 

see Section V.E) by typing | 


QU DP,RBIN;RF E,RBIN,2 
QU HL, FLIST 
QU SC,TEMP;RF E, TEMP,19 


We won't reserve a file for FLIST, since only one sector (an 

EOF) will be written on HL (see P3 parameter description of the 
FORTRAN Compiler description, Section VII.E). RBIN will be the 
relocatable binary from pass two, FLIST will be the listing, and 
TEMP will be the intermediate file. Now call the Non-EAU version 
of FORTRAN by typing 


RU FORT,,,2 


Note that the compiler was directed to take the control statement 
from FSRC, and to compile the second file on DI. Pass one is made 
on FSRC, with the intermediate file written in TEMP. FOR2N (pass 
two) is loaded autmoatically, the intermediate file is processed, 
and the relocatable binary is written in the RBIN file. Upon 
completion, the Executive is reloaded via a transfer to the System 
Loader. 


Now to process RBIN with the configured BCS system (ABCS, Absolute 
Basic Control System file); first, prepare the I/O units by typing 


RS;QU E1,RBIN 
QU E2,ABIN,ELIST;RIF E,ABIN,45;RF E,ELIST,4 
QU E3,BLIST;RF E,BLIST,5 


Note that disk logical units are refered to here, rather than 
functional units (DI, DP, and HL), since we want to insure that 
we use the proper Unit-Reference numbers (see Section VIII.D). 
ABIN will be the absolute binary file generated by ABCS, ELIST 
will be the entry point list, and BLIST will be the bounds list. 
Call ABCS by typing 


RU ABCS 


When the "*OPT" message is printed, type "PL" to direct ABCS 

to write the absolute binary file (ABIN) followed by an entry point 
list (ELIST) on the system Output unit (E2); when the "*LOAD" 
message is. printed, type "NL" to cause ABCS to load from the re- 
locatable library (LIBN) and list the bounds (BLIST) to the 
system list unit (E3); when the "*LST" message is printed, type 
any character except "L" (see Section VIII.D for a description 
of ABCS operation). Upon completion, the Executive is reloaded 
via a transfer to the System Loader. If an entry point or 
bounds list is desired, these can be obtained from E2 or E3 

with the List command. | 


Now execute the program by typing 
RD E,ABIN 


The program will be loaded and executed, and will request you 
to type the input data. After it has done the computation it 
will print the result, print another message, and reload the 
Executive via a transfer to the System Loader. 


It should be noted here that FDOS made several transitions 
between the SIO and BCS environments in this compilation, 
relocation, subrouting loading, and execution process: 


*After doing the compilation (FORT) in the SIO 
environment, the BCS environment was entered when 
ABCS was called; upon completion, the Executive 
was reloaded (back to SIO). 


*When the program was executed (RD E,ABIN) the 
BCS environment was again entered; upon completion, 
the Executive was reloaded (back to SIO). 


At this point the user should be reasonably familiar with the 
various aspects of FDOS. If a hardware configuration different 
from the "standard" as defined in Section V.A is desired, the 
following procedure can be used to build a "master working 
disk" (if the "standard" hardware configuration is acceptable 
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skip to the end of this section and delete files as is appropriate). 
Basically, the procedure consists of using the System Generator 

to configure and write new "system" files (SYS1, SYS2, SYS3, and 
SYSM), re-~defining the teleprinter channel for DEBUG, building 

a new ABCS, and deleting un-necessary files from the disk. 


PROCEDURE FOR BUILDING A "MASTER WORKING DISK" 


kek ERK Rk eK RK KR KR RK KR KR KK KKK KR KR KH EK 
NOTE: DO NOT REMOVE THE WRITE-PROTECT TAB FROM 
THE "MASTER SKELETON DISK" SHIPPED FROM THE 


FACTORY: 
i i i a a ee i i a oe 


+ et OF 
Se te F 


1. Install the "master skeleton disk" in drive D (the left-hand 
drive of the main FDS enclosure). 


2. Enter the Keyed-In Loader per Section V.C. 

3. Load and configure the FDOS Bootloader per Section V.D. 

4. Bootload the "skeleton" file (SYS@) using the X77@1B entry of 
the Bootloader with the Switch Register set to 14B (see Section 


V.D.2). 


5. Remove the "master skeleton disk" from drive D, and install 
a virgin disk in its place.. 


6. Halt the computer, turn off all power, configure the inter- 
face cards as desired, and turn all power back on. 


7. Execute the System Generator at location 2B. 


8. Proceed with the System Generation, starting at Section V.F.3; 
reply "YES" to the "FORMAT?" question in step 21. 


9. Install the "master skeleton disk" in drive E. 


10. Use the CODSK Batch file to copy all files (except SYS1, SYS2, 
SYS3, and SYSM) from drive E to drive D; this is accomplished by 


typing 
AS BC,E2;BA CODSK 
Note that CODSK can only be used in conjunction with the "master 


skeleton disk" (or a copy of it), since it assumes certain 
named files are on the disk in drive E. Upon entering the Batch 
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mode, CODSK types 


kkk **KKBEGINING OF CODSK BATCH OPERATION 
*AS BM,BK 


thus assigning the Batch Message unit to the Bit Bucket. Upon. 
completion, CODSK exits the Batch mode (BX), clears the buffers 
(ZS), restores the original SIO configuration (RS), and types 


eke *kkEXEND OF CODSK BATCH OPERATION 
kkk kK*EEEREFER TO APPENDIX G, STEP 19. 


A listing of CODSK is shown at the end of this appendix. 


ll. Remove the "master skeleton disk" from drive E, put it in 
its envelope, and store it per the directions on the envelope. 


12. If the console device (teleprinter) is not on channel 12B, 
re-define its channel for DEBUG per Section VII.D.2. 


13. Since the hardware has been re-configured, a new ABCS file 
must be built. This can be accomplished on the disk in drive D. 
First, the files that will not be used on the "working disk" 
(such as CODSK, SRCE, FSRC, LIBE, LIBF, SD36X, ASMBE, ASMBF, and 
FOR2ZE in a Non-EAU computer) must be deleted, since there is 
room for only thirty-one names in a disk directory. This is 
accomplished via the Delete command. Obtain a Disk Directory, 
and start deleting files from the bottom of the directory as 
appropriate. 


14. At this point,.the user should copy any additional BCS modules 
(drivers) that are to be used during DPCS onto drive D: Queue | 
each module to a logical unit of D, and then use the Copy command 
to transfer them to disk. 


15. Next, Queue the appropriate BCS modules to Dl; D.36 and D.36xX 
should be the first two (if they are to be included), and RLOA 
should be the last one queued. 

16. Now Queue ABCS, assign the I/O units, and call DPCS by typing 
QU D2,ABCS;AS DI,D1;AS DP,D2;RU DPCS 


The new ABCS will replace the "Standard" one; refer to Section 
VIII.A for details of the Disk Prepare Control System. 


17. Since we are now (theoretically) done with the BCS modules, 
delete them from the disk. 


18. Queue the library unit defined during DPCS (the standard is 
D4) with the appropriate library of relocatable subroutines 
(LIBN, LIBE, LIBF, or LIBX). 


19, Install a virgin disk in drive E, format it, and copy the 
disk you just built (use DUP to do this). 


20. Take one of the disks, write-protect it, label it "master 
configured disk", put it in its envelope, and store it ina 
secure place per the directions on the envelope. Thus, when 
the "working disk" gets misplaced, etc., a copy can easily be 
made. 


21. Repeat Steps 1 thru 4 to configure the Bootloader for the new 
channel assignments. 


If all the above operations work’ as indicated here, the FDOS may 
be placed into routine operation. 


CODSK Batch File Listing 


ee keee BEGINING GE COUSK BATCH OPERATION 

AS Bes BRK 

LY BCeRK+t12¢ ** THIS NUMBER MUST EGUAL COMMENT LINES 
** BATCH FILE TO COPY ALL DISK FILES FROM 

we MASTER SYSTEM OISk TO NEk SYSTEM DISK 

¥* PRUGRAMMER? OeKe LA VERNE 

**- CODING BEGUN! FAY Zia 1974 

¥e PRODUCT IDS 5029 REV. B 

ok 

x* EDIT HISTORY 

we ZT MAY 74 CREATE THE FILE 

OF 24 JLN 7H REARRANGE EACH LINE 

** 26 AUG 74 ADD IRITLAL @UEUE OF DISK LUDeS 

ke 08 CCT 74 ADD ASSIGNMENT GF DL & LP 

mK . 

AS DIvE1:AS DP yD 

SEtTG OleSYSOITE Oh SYSO 

SEGRE NP eSYSOsGLiCG eeeBAt TG DIeSYSOiTA DPeSYSOIVE eesBA 
TO'DTeSkKCESTA DPeSRCE 

RF OPeShCeeLAtCO ese se At TA DL eSRCEVTO DPeSRCEITVE ceed 
TQ OLeESRCITA DP eF SRC 

RF CPeFSRC~4sCO eee At TG BDIeFSRCOLTTG GPeFSRCiVE eeed 
TQ OLeLIBNe TQ OPeLIBN 

RF DPeLIGNe@ZiCO ee eBiTA NLelLIBNeTO DReLIBNIVE ee eB 
TO OLeLIBEITS CPeLibe 

RE OPeLIBE s+ B8GiCO eeeRi TQ DIeLIBEsTE DPeLIBESVE ee eB 
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TO NIGhLIBFSTG OPeLIBE . 
RF NPs lithe 761CO ee e Phi TQ DIeLIBFITO DPeLIBFIVE ee +B 
TO NIvCOOSK TG Oe CODSK 
RF AP sCOUSKs+LUECO eeeAs TG DIeCOOSKETA DPeCGDSKIVE eed 
TQ OLSELITS TC CheEDIT 
RF OP FLIT«TOICO wee bAi TO O1L,ELIT:TO GPeEDITIVE «eeBA 
TQ DTeASWBNGTU DPeASMEN 
RF DP eASHPEN s+ S27C0O wees BACT GLI ASMBNI TH OP eASMBNIVE eee BA 
TQ HLeCROSSTG OPACROS | 
RF DPwCRGS+«S9iCO esesBAtTG DIeCROSITO DP,yCROSIVE oa eBA 
TQ OLeFGORTITG OP s FORT 
RF DP eFORTeSSICO see BALTOG OLeFORTIETO DPeFORTIVE eee BA 
TQ OL eFOR2NS TQ OP PFORZIN 
RF DP FORM e1ot CO. eesEATTO BDIsFORKANETG DPeFORANIVE eos BA 
TQ OL-+DUP:TQ UPyDUP 
RF CPyORPe4CG eee EATS BCTeCUPST@ CRPeDUPIVE eee BA 
TQ DPI SPERUGI TS DOP eCEEUG 
RF GP,sCEBLGseSiCO eee BATE OL DEBUG TA NP«DEBUGIVE «BA 
TQ DI+hXERTTG GOPsEXKER 
RF Of eeKxE Re COSCO ee e BAI TE OIEXOCRITG DPeEXERIVE eee BA 
TQ DITeABCSITS OPGAECS 
RE DP eARCS es 52:C0 ee sPATTE OLeABCS:iTO DPeABCSIVE oo eeBA 
TQ DTeOPCSIETS GPeDFCS 
RF PPeGkhCSei Gs CO sesBhe TG DIeOPCSiTe@ OP eDPCSIVE ee ehA 
TSH P1ish.26¢TQ DP ee 26 
RF OP S6sLBICO see BiTQ DID SGiTR DP.~D-363VE +428 
T9 NY he FEXt Te DP e Oe 26> 
KF GPeb.eSEKeUtCO soe bt 16 DI eDe 3EKtTO CPeOe S6XtVE so eB 
TO OIsGe003TO OP eO.00 
RF AP eOeOCOeGiCo eee Bs TE OIG OO TO OPeD.OGIVE oeeB 
TS Oieh.35tTQ OP +O.45 
RF DPseh.S5e71CG eee Bi TY CIE. S5:7TS DP»D.-353VE eee 
TQ NYeelLuCe it Te DF eelOCe . 
RE DP eT OC ee SiCO eee BiTG Ole LOC ei TO OP eo lOCei VE eo eB 
TO DNEELGAITS DPeRLOA 52 Gm 3 
RF CPsRLOAelL3CO eae Bs TG DIeRLOASTQA DPseRLOASVE oe eB 
TQ DU SUZEXtTE DP+SDZ6A 
RF DpeSUS6Xe4iCO seeAt TO DI»SDZ6X+TO DPeSUSEXIVE ceed 
TO DIeASHMEE? Te GPeASHRE 
RF BPs ASMBEE s+ 327CO eee GAiT@ DIrzASMEES TG DPeASMBES VE oe e BA 
TQ DIsASMBFYTY DPeASMEF 
RF DP«ASMBFeZ2iCO eee EAS TA GIeASMBF TQ OPeASMBFEVE o¢ «BA 
TQ ATeFORGE: TQ DF «eFGR2E 
RF GP eFORP2ZEeLo;CO eee bas TO CleFORECE;T@ DPeFORGE VE ++¢BA 
QU DNTeSKCEsFSRKCeSHS6XiGU D2.~CuDSK 
GU NEN 56eVe SEX ele CO e S5e0oTUCe se RLOALOCU DG eLIBNeLIBE eLIRF 
LI BeClLet2sPRk BCURK TESTERS 
goat ENO OF CODSK BATCH OPERATION. 
xeee REFER TO APPENULX Ge STEP 10. 
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